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Preface 



This Prograni Logic Manual (PLM) is a 
detailed guide to the IBM Disk Operating 
System, On-Line Test Executive Prograni 
(OLTEP). It supplements the program 
listing by providing high level text, lafcel 
list, tables, and flowcharts. 

This manual is organized in nine 
sections consisting of: 

• Introduction ; Describes OLTEP 
functions, structure and relationship 
to the system. 

• Text of Phases ; A composition of each 
phase making up the executive program. 
The primary phases are in succession of 
use. The support modules are in 
numeric sequence. 

• Charts of the Phases ; Summarized 
blocks of coding within the program 
units depicted. The charts of the 
primary phases are in succession of 
use. The support module charts are in 
numeric sequence. 

• APPENDIX A : Contains the message 
cross-references . 

• Glossary of OLTEP Terms . 

This sectional organization allo^^vs quick 
access of pertinent information required by 
the OLTEP program support personnel. 



PREREQUISITE PUBLICATIONS 

Effective use of this manual requires a 
thorough understanding of IBM Systein/370 



programming concepts. The publications 
providing this information fellow. 

Note: Although titles of some EOS 
publications have been simplified, the 
change does not affect the contents of 
the publication. 

• IBM S vstem/37Q Prin ciT:les of Operation , 
GA22-7000. 

• DCS/VS Data Managem ent Guide , 
GC33-5372. 

• DCS/VS System Cont rol Statements , 
GC33-5376. 

• Introduction to DOS/VS, GC33-5370. 

• DCS/VS I PL and Job Control. sy33-8555 

• DCS/VS Librarian, SY33-8557. 

• DCS/VS Linkage Editor, SY33~8556. 

• DCS/VS Lc qival Trarsients . SY33-8533 

• DCS/VS Supervisor Logic, SY 33-8551 

RELATED PUBLICATION 

• DCS CLTEP, GC33-5383. 

Titles and abstracts of other related 
publications are listed in the IBM 
Svstemy360 and Svstem/3 70 Biblio graphy , 
GA22-6822. 
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Introduction 



OLTEP FUNCTION 

IBM provides a set of prcgrairs to test I/C 
xmits . These test programs and the On-line 
Test Executive Prograir irake up the On-line 
Test System. The On-Line Test Executive 
Program (OLTEP) is an interface between the 
system and the test programs and 
communicates with the operator during the 
running of tests (Figure 1) . 

Some uses of DOS OLTEP are: 

• Diagnosing I/O errors. 

• Verifying I/O device repairs and 
engineering changes. 

• Checking I/O devices. 

Some features of DOS OLTEP are: 

• Multiple device testing. 

• Data security. 

• Data protection. 

• No re-IPL time required. 



• Promipting . 

• Pecognize MCII labels; restore ASCII 
labels. 

• Accessing cf error recording 
in for mat ion. 

• line connection routine for remote 
terminal testing. 

• SCSP support. 

• BETAI N/370. 

• Trace option -- will provide a trace of 
CITEP modules entered from the OLT. 

• Equate function -- provides the 
facility to use an existing 
configuration data set (CDS) to test a 
similar device for which no CDS has 
been generated. 



CITEP operates much like ether problem 
programs in the Disk Operating System.. It 
is cataloged into the core image library 
and called by standard job control 
statements. When OLTEP is executed, it 
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Figure 1. OLTEP System Relationship 
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notifies the operator that it is active and 
communicates with hiir during testing. 
OLTEP can run in a batch- only system or as 
a background program in a multi pro gram 
environment. It requires a irinimiM 
partition size of 14K of real storage and a 
supervisor which supports 0L1EP- 

You can test an I/O unit with minimum 
interference to other prcgrairs running on 
the system. Testing an I/O device 
ordinarily does not interfere with system 
input and output. Any unit being tested, 
except for direct access devices , must not 
be assigned to the foreground partitions - 
Eirect access devices, hcwever, may be 
shared. 



• CI TEP Transient ; The transient area is 
reserved fcr modules that have limited 
use and need net be resident. One or 
m,ore transient modules can be in main 
storage at a given time. These 
modules, when needed, overlay 
previously loaded ircdules that are no 
longer being used. 

• PIT i^ rea; One area cf at least 4K is 
reserved fcr the OIT. 

• BETAIK/370 Interface (RED : The 
FETAII^/370 interface, when active, 
occupies the last 4K cf the background 
partition. 



An OLTEP user language defines and 
controls the test- Viith this language the 
user selects the devices tc test, the test 
sections to run, and the options to 
exercise. Be enters this information via 
the console device or in the fcrm of 
control records in the jcb input stream. 
This information is referred to as the 
test-run definition , and is ccmmon to CITEP 
components for all operating systems. 

You can test multiple devices of the 
same type with no operator interventions 
other than those required fcr data 
protection and data security. OLTEP loads 
and executes the test sections one at a 
time until all the tests fcr one device are 
completed. The test sections then repeat 
for the next device if one is requested and 
is available. Testing continues in this 
manner until all units in the test- run 
definition are tested. 

During testing under control of OLTEP, 
the system error recovery procedures are 
bypassed on the device being tested. OLTEP 
has built-in data integrity safeguards so 
that no data is destroyed and no security 
protected data is accessed during testing 
without permission of the operator. 



OLTEP STRUCTURE 



OLTEP requires a minimum of 14K in the real 
background partition and 18K with 
RETAIN/ 370 active (Figure 2). Because all 
the OLTEP and On-Line Test (OLT) functions 
exceed this allotted space, transient 
modules are loaded and executed as needed. 

The background partition is divided into 
four areas : 

• OLTEP Resident ; The OLTEP resident 
area (nucleus) consists cf tables, 
pointers, and coding that must reside 
in main storage during OLTEP execution. 



CN-LINE TESTS (CLTS) 



CLTs are called into irain storage for 
execution by the scheduler portion cf the 
CLTEP nucleus. Tests normally do not 
exceed 4K. However, those that do are 
loaded if the allotted background partition 
is large encugh. If an OLT requires 
greater than 4K and there is not sufficient 
space for the CLT, OLTEP generates a 
message and proceeds to run the next OLT 
(if any) . 
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OLTiiP allows the 0L1 to be divided into 
a root segirent and associated test modi3les. 
i^.lthough the root segirent irust remain in 
main storage for the duration of a 
particular test, the supporting test 
modules can be loaded frcir the core image 
library as they are needed. 

Infornation about individual tests 
appears in the writeup that accompanies 
them. 



1. Protect custcirer data. 

2. Allcvv effective testirg within 
constraints of data protection. 

3. Kiniirize manual interventions. 

All requests for device testing are 
channeled through the data prctection 
modules. The following secticns show the 
data protection measures invoked for 
specific device types. 



OPERATOR COjyiMUNICATION 



All Devices 



OLTEP gives the operator maximum control in 
running the tests. If a console device is 
assigned to the systen and you do not 
choose to enter the test-run definition by 
card^ OLTEP will establish a canmunications 
interval . Once the ccirrrunications interval 
is initiated, OLTEP issues a message 
requesting you to enter the test-run 
definition. At this tiire, ycu can enter or 
change the testing procedure or terminate 
OLTEP by entering CANCEL. The four methods 
of initiating a communicaticns interval 
are: 

1. The initial comirunicaticns interval 
automatically occurs when CLTi.P is 
first called in, unless the test-run 
definition is entered by card. At 
this time, the initial test-run 
definition is entered. 

2. You can invoke an interrupt 
communications interval by pressing 
the interrupt key on the console. 

3. The first-error communications 
interval occurs when an error is 
encountered during a tett. The 
operator can suppress it by entering 
NEE (No First Error) as an option in 
the test -run definition. 

4. The test completion ccmirunications 
interval automatically occurs when the 
specified testing procedure ends 
unless the test run definition was 
entered via card input and another 
card is present. 



LATA PROTECTION 



CLTEP assumes m.uch of the responsibility 
for the protection of customer data. The 
data protection modules within CITEP 
protect customer files and storage during 
the on-line tests. Objectives of the data 
protection modules in the order of their 
priority are to: 



A device ready check is perfcrned on all 
devices to satisfy the ready requirement 
for the tests and to allow execution of the 
data protection checks. If the device is 
not ready, a iressage containing sense 
information and the channel status word 
(CS^) is issued. The operator is tben 
given options to control further testing of 
the device. 

M2te: For a detailed description of 
the rressages and replies, see the DOS 
CITEP publication listed in the 
Preface. 



Tape Devices 



Before a tape device is tested, OLTEP makes 
three checks: 

1. Standard Label. OLTEP checks for a 
standard label to ensure a test volume 
is mounted. If a standard label is 
not recognized, CITEP checks for a 
standard label in ASCII mode. If a 
standard label is not reccanized at 
this tiire, a iressage is issued stating 
that a nonstandard labeled tape is 
mounted. The operator is then given 
the option to bypass the test, retry 
the test after mounting a different 
tape , or to proceed testing with the 
tape that is mounted. 

Is ot e; If no bit pattern is read (tape 
is new or clean) , CITEP will read to 
the end of the reel, rewind, and 
retry. To avoid this, some hit 
pattern (e.g. tape mark) must be 
written on new or clean tapes. 

2. Security. OLTEP checks the security 
byte in the VOLl label. If on, a 
iressage is issued indicating this 
condition to the operator. The 
operator can bypass the test or retry 
the test after mounting a different 
tape . 
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3» Expiration Date. The expiration date 
is checked to deteririne if it has 
expired. If it hasn't, a message is 
issued stating the voluire cannot be 
used as a scratch. Options are then 
available to bypass the test, retry 
the test after counting another tape, 
or to proceed testing with that tape. 

When testing of a tape device is 
completed or discontinued, and a standard 
label has been successfully read before 

testing^ OLTEP rewinds the tape and vvrites 
a standard lab^l. The fcllcmng records 

are written s 



^^^^^^^^^ — -. .™.-.-— .^-^.^ ».-- ^— — -, 

I VOLl I Volume S/N I 70 bytes of zeros | 

^„^^^^^+^^^^^^^^^™-.^^ ^ ^ -.^^H 

I HERl 1 76 bytes of zeros | 

OLTEP does not attempt to write a label 

if a standard label was not read at the 

beginning of the test. 



If the volume label is a standard label, 
a check is made to determine if the volume 
is security protected. If the volume is 
security protected, the volume cannot be 
used as a test volume and ycu are given the 
option to bypass or retry. If the volume 
is not security protected, a check is m«ade 
to determine if the volume serial number is 
CEFACE. If it is not CEPi^CK, you are given 
the option either to bypass the test, retry 
after mounting a different pack, or proceed 
testing in the file protect mode (EPM) with 
the pack that is mounted. If the volume 
serial number is CEPi^CK and is not security 
protected, testing is allowed to proceed in 
non-file protect mode unless the voluire is 
shared with another partition. In this 
case testing proceeds in FPM. 

Kote: System protection of system secure 
data sets is bypassed and system secure 
data sets iray be destroyed if the yolume is 

not security prctected. 



IBK 2321 



Unit Record and TP Devices 



The device ready check is the cnly data 
protection task performed on unit record 
and TP devices. 



Direct i^ccess storage Devices 



If the device to test is an lEJ^ 2321, OLTEP 
ensures that the CE vclume is mounted in 
bin 0, then turns control ever to the test 
section. If CLTEP finds that the volume 
mounted in bin is not a CE vclume, it 
gives the operator the option to bypass the 
test, or retry the test after mounting a CE 
data cell. 



The device ready check is the initial data 
protection task performed on all direct 
access devices. If the device is ready, 
OLTEP determines the type of DASD being 
tested, and performs the data protection 
tasks for that device type. 



IBM Di^SD DEVICES OTHER THAN 2321 



A read comimand is issued by OLTEP to read 
the volume label. If the device is a 333 0. 
bit 5 of the home address is checked. If 
the device is shared and bit 5 is on, 
testing proceeds file protect mode. If the 
device is not shared and bit 5 is on, 
testing proceeds in non-file protect mode. 
If the bit is off, or the device is not a 
3330, the data protection checks (described 
in the following paragraphs) are performed. 

For non-shared 2311/2314 devices, 
cylinder 6, track 0, record is checked 
for FOFE. If it is present testing is 
allowed in non-FPM, Otherwise data pro- 
tection checks are performed as described 
in the following paragraphs. 



Space Allocation 



Before write testing is performed on a 
volume other than a Custcirer Engineer 
volume or a scratch pack with a volume 
serial number of CEPACK, CLTEP issues a 
message asking if volume data can be 
destroyed. If the reply is YES and the 
device is not shared, testing proceeds in 
non~FPB(. otherwise, testing proceeds in 
FPK. 

^ote: If testing is ir ncn-FPM, the test 
section may reformat the vclume. 
Reformatted volumes are not recognized as 
usable by the operating system. 



File Protect Mode (FPM) 



File protect mode allows limited testing of 
a direct access device without destroying 
volume data. While in FPM, CLTEP scans the 
channel program for any Write commands that 
violate data security cr protection. OLTEP 
can perfcrir only a liirited test when 
operating in this mode. 
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Non-File Protect Mode (ncn-FPjyi) 



When operating in non-FPK, OLTEP allocs the 
test to perforin Write and Read Data 
operations en the device. Cylinders in the 
CE voluire are allotted for this function. 
The saire cylinders are used en both CE 
voluines and scratch voluire s. 



contains an entry point intc the 
supervisor, which is used tc exit frorr the 
supervisor state. At the second issuance 
of the SVC, register 1 contains zeros. 
This forces task selecticn- 



RETUBK CODE USi^GE 



i^CCESSING Of ENVIRONMENTAL RECORDING DATA 



OLTEP can retrieve records from an 
environir.ental recording data set (Error 
Recording Environitiental Procedures (EREP) 
history tape) for use by the OLT. 

OLTEP has the ability tc access an^ one 
of the following data sets: 

1. EOS System Recorder File (SYSREC). 

2. EOS Eistory Tape. 

3. OS Bistory Tape. 

Upon receiving a request fran the CIT 
for this inf oriTiation, OLTEP checks to 
determine what media the data set resides 
on. If the operator responds tc access the 
SYSREC file, OLTEP will perform all the 
necessary functions to access the file. If 
the EREP history tape is tc be used, CITEP 
requests the operator tc mount the tape on 
a free device and enter the device address. 
This device must be assigned to the 
background partition, but not included in 
the test-run definition. 

The error recording data set is searched 
sequentially beginning from where the last 
record was retrieved. However, if the 
RESET=YES parameter in the LCGSCN macro is 
specified by the OLT, the search always 
starts at the beginning of the data set. 



SVC 4 6 EOS-OLTEP SUPERVISOR CALL 



Because CITEP is a multiphase program, it 
miust communicate between modules. Also, 
the results of operations requested by the 
CLTs must be passed back frcm OLTEP. To 
accomplish this, the possible results have 
teen equated tc hex codes. These hex codes 
are returned via general purpose register 
15 for examination by the requesting phase. 



REGISTER CONVENTIONS 



Registers 0, 1, and 14, 15 can be used by 
the unit test but the contents will b e 
destroyed by va rious macros . 

Registers 4, 5, 6, 7, 8, 9, 10, 11 can 
be freely used. 

Register 12 must be reserved for an 
additional base register. 

Note: The CC set by an instruction 
preceding a macro call is not preserved 
through a macro call. 

General register conventions of the 
operating systems are observed. They are: 



GR 



Usage 



15,0 Supervisor parameter registers 

1 Parameter list register 

13 Pointer to save area 

14 Return register 

15 Entry point register 



The SVC 46 was designed for DOS OLTEP. 
When it is issued the supervisor checks 
that the request originates from the 
background partition. It then checks for 

OLTEP running in the background, by testing 
the OLTEP bit in the system communication 
region. This bit is set by a B-transient, 
$$BOLTEP, called by the OLTEP initializer 
(IJZADOLT) . 

By issuing the SVC 46, OLTEP is put into 
the supervisor state and is then able to 
issue privileged instructions or store data 
into the supervisor area. At the initial 
issuance of the SVC, register 1 contains an 
entry point in OLTEP, and register 7 



In addition, the following CLTS 
convention must be observed: 

GR Usage 

2 Pointer to section control table (set 
by IKTLZE macro) . 

3 First base register of CSECT, 
established as base register by the 
INT'LZE macro instruction. 

13 Must point to save area when issuing 
a MACRC call. 

15 Return code register. 



Introduction 13 



RETi^IN/370 provides a ccnirunicaticr.s path be-tweer. the 

on-site custcner engineer and the reircte 
specialist via the reircte analysis center. 

With the REli^klN/STO feature cf CLTEP a 

remote specialist can ccntrcl and obtain Eequirenents and detailed cperatinc 

the results of the on-line tests. Vvhen the procedures fcr BETAIN/370 are found in DOS 

RETAIN/370 interface is active, OLTEP CLTEP, GC33-5383. 
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OLTEP Primary Modules 



The primary modules that perfcrm the basic 
fimctions of OLIEP includes 

1. Nucleus (IJZADOTM) 

Consists of the following CSECTS: 

a. Coirroon Area (DOLTCOMN) 

• Defines collection of constants 
and routines which are available 
to all OLTEP module s. 

b. Transient Manager (IJZADOIT) 

• Loads requested mcdules and 
passes their entry point to the 
requester, or enters them as 
requested. 

• Remains resident; maintains a 
table of transient modules 
available in the transient area. 

c. I/O Interrupt Handler (iaZADC98) 

• Bandies interrupts for devices 
on which an EXIO has been 
performed . 

d. External Interrupt Handler 
(UZAD094) 

• Receives control from DOS when 
an external interrupt occurs. 

• Posts interrupt if it has an I/C 
operation active en the device. 

e. Initializer (IJZAINIl) 

• Sets up coirmcn area. 

• Initializes switches. 

2. Communications Interval (IJZAD052) . 

• Issues the ENTER DEV/TESI/OPT 
message. 



• Preliminary analysis cf the 
operators respcnse. 



3. D ata Protection . 

• Performs the necessary data 
protection tasks, en the test 
device, to ensure the customer's 
data is not destroyed. 

4. S cheduler (IJZACOOO). 

• Loads the requested CLT. 

• Returns control to the 
communications interval module after 
all the specified devices have been 
tested. 

5. DECODE Kcdules. 

• Decode the reply to the ENTER 
DEV/TEST/OPT message. 



With the exception cf the NUCLEUS, the 
phases that make up OLTEP are cf a 
transient nature. That is, they are called 
in as needed. A phase may be requested at 
different times by different phases. Thus, 
to ensxare efficiency cf cere and to prevent 
reloading a loaded phase, all phases are 
loaded and monitored via the transient 
manager. The transient manager is a 
resident phase. 

All the desired on-line tests are 
scheduled and loaded via the scheduler. 
Figure 3 shows the overlay structure of the 
OLTEP modules. 

The detailed module descriptions that 
follow are in the order they are initially 
entered . 
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location 
S+0 



See 
note 1 



OLTEP 
AREA 



DOLT 



^ O ^ S O 



u 



41 



35 



02 



1^^ > |44 1 
-L 7 



77 
78 



36 

45 _]47 l42 
143 



62 



64 



n 



39 

70 J_AA 



24 



49 



03 



07 



00 



T 



28 
22 



26 



DOLD 



31 



56 



AJ 



40 



33 



32 



71 



57 



52 



16 



JAB 



37 



location S + X'2788' 



END OF 

BG REAL 

PARTITION 



l'« 



I 



OLT area is variable,, depending on 
size of BG, minimum of 4k must be 
available for OLT. If RETAIN is 
not active, the area available to the 
OLT extends to the end of BG partition. 



Notes: 

1. Modules overlay IJZAD098 only if a P3n6 Architecture OLT is active. 

IJZAD098 will be refreshed when an AR145 Architecture OLT is active. 

Module IDs shown as 2 numeric digits are preceeded by "JJZADO." 

Module IDs shown as 4 alphabetic characters are preceeded by "I JZA." 

Module IJZADOIO is loaded 4K bytes before the end of the BG partition. 

OLTEP module IJZADOLT is loaded at S + (end of Supervisor). 

OLTs are loaded at S + X'2788'. 

OLTEP B-Transient modules UZAOLTP ($$BOLTEP) and IJZATOLT ($$BTOLTP) 

are loaded into the Supervisors B-Transient area. 



Figure 3, OLTEP Overlay Structure 
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IJZADOLT: Nucleus Chart iUl 



OBJECTIVES : This ir.odule, the Nucleus, is 
composed of 5 CSECTS. The Nucleus is the 
first module loaded by the system and 
consists of: The Initializer, Transient 
Manager, Interrupt Handlers (I/O and 
External)^ and Common Area. The CSECTS 
included in the module are: 

• DOLTCOMN - Constants and ccmmon code 
available to all modules, 

• IJZAEOLT - Transient Manager. 

• IJZAE09 8 - I/O Interrupt Handler. 

• IJZAE09 4 - Device External Interrupt 
Handler. 

• IJZAINIT - OLTEP Initializer. 



EXITS: 
1 



To transient manager (CSECT IJZADOOl 
within IJZAECLT) if entry was via 
#EXIT. 

To caller via R14 if entry point was 
$K0DSIZE. 

To the scheduler at SOOETERM if entry 
ras $DTRMLNK. 

To CECOM module (IJZAE037> if entry 
Mas #CECM. 



5. To the CCNVERT iTCdule (IJZAE041) if 
entry was #CCNV. 

6. To IJZAEC98 if EXIC is active; 
otherwise to the EOS supervisor. 

7. Return tc caller (IJZAEC98 or 
IJZADC94). 



EXTERNAL ROUTINES: 



CSECT EQLTCOMN: Constants and Common Code 



1 • Ncne 
2 . SVC51 
3.-7. None 



OBJECTIVES; 



Contains tables and work areas INPUT: 



common to all OLTEP modules plus linkages 
to commonly executed code as explained 
below. 

ENTRY POINTS ; 

1. #EXIT — Common entry for calls to the 
transient manager. 

2. $MOESIZE — Entered tc determine size 
and presence of a phase in the core 
image library. 

3. $ETRMLNK — Linkage tc scheduler on 
return from an OLT. 

4. #CECM^ — ^Entered to perform linkage to 
the CECOM module (IJZADC37). 

5. #CONV — Entered tc perform linkage to 
the CONVERT module (IJZAD041). 

6. $IOENELE — Entered from DOS supervisor 
on all I/O interrupts and prior to 
issuing all SIOs. 

7. $POSTPIE — Called by the I/O and 
external interrupt handlers when an 
event occurs to post the SETIME TECB 
complete. 

Note : Each numeric entry in the EXITS, 
INPUT, OUTPUT, and METHOD paragraphs below, 
relate to corresponding numeric entry in 
the ENTRY POINTS paragraph abcve. 



1. Pointer to parameter list (Rl) which 
is passed to the transient manager. 

2. Rl points to an 8-byte ircdule naire. 

3. R15 (fcr eld OLT's) contains a return 
cede tc indicate success cr failure 
for the execution cf the OLT. 

4. R14 points tc a parameter list which 
contains: 

Byte — Character count cf the 
message tc the output. 

B;yte 1 — Character count of the 

field reserved fcr reply. 

Bytes 2-3 — The address in the form, 
of an 'S' type address 
constant (AECON) which 
points tc the iressage 
tc be output. 

Bytes 4-5 — The address in the form 
of an 'S' type ADCON 
which pcints to the 
buffer reserved fcr the 
reply. 

5. Parameter list pcir.ted to by R14 which 
contains: 

E]^te — (Bit =1) Ccnversicr is 
from EEX tc EBCDIC. 

Byte — (Bit 0=0) Ccnversicn is 
from EECEIC tc HEX. 
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Page of SY33-8568-0, Revised October 31, 1973, By TNL: SN28-2567 



6. 
1. 



Byte (Bits 1-7) and Byte 

1 — Contains ccimt of bytes 
to be converted. 
Bytes 2-3 — Contains the 'from' 

address in the form of 
an ■£• type ADCON. 
Bytes 4-5 — Contains the 'to* 

address in the form of 
an "S" type ADCON. 

GPR 5 points to the return address in 
the supervisor. 

GPR14 points to the return address of 
the caller. 



OUTPUT : 



3. 



None if call is to the transient 
manager. 

RO contains the high address of the 

selected module. 

Rl contains the length cf the selected 

module. 

RO contains the success/fail indicator 
if entered from an eld OLT. 



4. Rl points to a parameter list ^lihich 
beccmes input to mcdule 1JZAD037. 

5. Rl points to a parameter list ^^hich 
becomes input tc mcdule IJZAD041. 

6 . None 

7 . None 



MET HOE : 

1. Loads R15 with entry pcint of 
transient manager and branches to this 
address. 

2. Issues an SVC51 with Rl pointing to a 
work area which contains the phase 
name in the first eight bytes. The 
supervisor call returns the phase 
header in the work area. From this 
information, the module length is 
calculated and returned in Rl and the 
high address is calculated and returned 
in RO. Rl will be zero if the phase 
does not exist. The caller is returned 
to via R14. 

3. The return code in R15 is placed in 
RO; the scheduler's registers are 
loaded from a save area in common; and 
the scheduler is leaded via the 
transient manager and entered at 
location $ETiyiADD. 

4. A full parameter list required as 
input tc IJZAD0 37 is ccnstructed using 



the abbreviated parameter list passed 
as input. R14 is updated to point to 
the return address, then IJZAE037 is 
entered via a call tc the transient 
manager. 

5. A full parameter list as required for 
input tc IJZAE041 is ccnstructed using 
the abbreviated parameter list passed 
as input. R14 is updated tc point to 
the return address, then IJZAE041 is 
entered via a call tc the transient 
manager. 

6. The $CCE1USE and $CCE2USE bits in the 
common area deternine if OLTEP has 
outstanding CLT EXICs. If there are 
outstanding EXIOs, IJZi^E098 receives 
ccntrcl; otherwise, a return tc the 
supervisor occurs. 

7. The TECE in ccmmcr is posted complete 
for the SETIME issued in WAIT 10. 



TABLES AND WORK AREAS : 

1. Section Ccntrcl table. 

2. Device Entry table. 

3. Secticn List table. 

4. Transient Manager Vector table. 

5. $CLTPi^.RK table (Certains addresses of 
locations in conircr that are passed to 
the CLT). 

6. CCB's fcr use by CLTEP. 

7. Program Information Elcck (PIE). 

8. Timer Event Ccntrcl Elcck (TECB) . 

9. CLTEP flags in EOLTCOMN. 



r.cjFr'T T.T7. annrpM* 



OBJ ECTIVES; Handles test secticn linkages 
to CLTEP. Also, determines if supporting 
modules are resident or reed to be loaded. 
Kodules loaded will renain in core and are 
overlaid by another module. 

ENTRY POINTS; 

1. EXIC — tc call IJZAECLE tc issue OLT 
1/0. 

2. VvAIT — tc call IJZAECLE tc wait fcr I/O 
completicn. 
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3. EPRT— to call UZADOLD. 

4. EPPADOTM — to process AR-ia5 OLT 
requests. 

5. iPZADOTM — to process OLIEP requests. 

EXITS ; To irodule requested by caller's 
parameter list; or to caller if ftmction is 
not supported or is a lead only request? or 
to coinmunications interval (IJZAD052) if 
operatior coroitiunicaticn is desired. 

EXTERNM. ROUTINES : 

1. Trace (IJZAD045)--f cr trace function 
and return code handling. 

2. $MOESIZE — to deteririne if requested 
module exists and fits into available 
storage . 



INPUT : 

1. GPR15 — address of entry point. 

2. GPRl — parameter list address; this 
list contains: 

• byte — transient manager flags. 

• byte 1 — macro level. 

• bytes 2 and 3 — ^ module ID in EBCDIC. 



OUTPUT : 
1 



2. 



GPRIS^ — entry point address if calling 
requested module or return code if 
returning to caller. 

GPRl — for calls to IJZADOLD parameter 
list which indicates an EXIO, liiiAIT, or 
EPRT request. 



METME: Five entry points are used to 
control the contents of the transient area: 

• Three are for P3116 OLTs. 

• One is for AR-145 OLTs. 

• One is for OLTEP requests. 

The three entry points (#1, #2, and #3) 
for P3116 OLTS support EXIO, WAIT, and DPRT 
functions. IJZADOLT is called to calculate 
the entry point, deteririne the requested 
function, and pass a parameter list for the 
function to IJZADOLD. IJZADOLD then 
performs the function. 

The AR-145 entry point (#1) saves data 
for return code handling and tracing. The 
return code is altered so that when the 
fimction has been performed, the called 
module returns to the transient manager. 
The transient manager then call IJZAD045 to 
perform the trace and return code handling. 

The OLTEP entry point (#5) initially 
processes internal OLTEP requests. Since 
modules in the transient area can exit to 



an overlaying module, the data in the 
registers cannot be saved in the callers 
save areas, and is stored in a save area in 
the transient manager. 

When the entry point is #4 or #5, a 
check is first made to determine if tbe 
operator has requested a ccmmunication 
interval by causing an external interrupt. 
If the interval is requested and OLT is not 
executing cleanup, IJZAD052 is called to 
perforir the comimunicaticns interval. 

If the operator comiranicaticn interval 
is not requested or cannot be performed, 
the table of modules currently in storage 
is searched f cr the requested module. If 
the module is in storage, control is passed 
to the requested module. 

If the module is not in storage, a load 
only request is returned to the caller and 
an eight character phase name is generated. 
If the request is from an OLT, the SMOESIZE 
routine is called to determine if the 
module is in the core image library, and if 
it will fit into the available storage. If 
it is not possible to lead the module into 
available storage, a return cede of 4 is 
passed to the caller stored in GPR15; 
otherwise , the requested module is loaded 
into storage and the table of modules is 
updated to reflect the modules currently in 
storage. Control is then passed to the 
requested module. 

When the module has cemtpleted its 
function, and ccntrol is returned to the 
transient manager, a check is made to 
determine if trace is active or return code 
handling is required. If trace is active, 
the trace module CIJZAEC45) is called. 
When trace is completed, cr if trace is not 
called, the OLT registers are restored and 
control is returned tc the OLT. 



CSECT IJZ AD098; I/O Interrupt Handler 

OBJECTIVE : This miodule receives control on 
all interrupts and SIOs when an OLT EXIO is 
oustanding. It determines if the interrupt 
or SIC is a result of an EXIO and, if so, 
posts relevant information in the TECB 
associated with the I/O request. 

ENTRY POINT: Label EPZAD098. 

EXIT: TO caller via GPR5. 

EXTE RNAL ROUTINE: $IOBNDLE, $POSTPIB 

INPUT: Device address in GPR2 on SIO. 
CCB address in GPRl. 
Return address in GPRS. 
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OUTPUT: Posting in TECB (sense data). 

METHOD : UZAD098 is a separately loadatle 
phase which becomes a part cf the NIXIEUS 
when a "NEW Architecture (AR-145) " OIT is 
being executed. IJZAD098 may be overlaid 
by IJZACEOM, IJZACONV, IJZARATA, IJ:ZACPUT 
or IJZACOMP, as these functions are 
required, when "OLT Architecture (P3116)" 
OLTs are being executed. IJZADOOO 
(Scheduler) will reload IJZAD098 whenever a 
"NEW" OLT is being executed after execution 
of an "OLD" OLI. 

This module receives control from the 
$IOBNDLE routine in coirmcn when an 
interrupt or SIO occurs and OLTEP has an 
outstanding EXIO. 

When control is received, GPRS contains 
the supervisor return address. The module 
checks the instruction at the return 
address. If the instruction is a SIO, the 
device address is retrieved from GPR2; 
otherwise, it is retrieved from the I/O old 
PSW. 

The device table is searched for a 
matching device address with I/O active. 
OLTEP then determines if this is an 
interrupt or a SIO. If an interrupt, CITEP 
checks the device table to see if this 
entry is not accepting interrupts, in which 
case, control is returned to the supervisor 
at the proper return point. If the device 
is accepting interrupts,, and if control 
imit end only is on is the status byte of 
the CSW, the status is pcsted to the TECB 
as a valid interrupt. 

If the activity on the entry is a SIC, 
OLTEP further checks the CCB address to be 
sure that this is the correct entry, and 
returns to the device table search if not 
correct. If the CCB address does not 
match, a flag is set to indicate that this 
is an OLTEP SIO and the SIO is issupd* 

The following actions occur depending on 
the condition code specified: 

• CC = — A bit is set to indicate that 
subsequent interrupts should be posted. 
The GOOD SIO bit in the device table is 
set. If the macro level of the EXIC 
was three, the condition code is posted 
in the TECB. In any case, the 
condition code in the PSW is set to 
zero with a SPM instructicn. The 
registers are restored and the 
supervisor is returned to four past 
GPRS. 

• CC = 1 — If busy is on in the status, 
the condition code is set to one with a 
SPM instruction. The registers are 
restored and the supervisor is returned 
to four past GPRS. Otherwise the 



accept interrupt bit is reset on every 
entry in the device table with same 
device address. The accept interrupt 
and gccd SIO bits for this particular 
entry are set as is the event complete 
bit and then ccnditicn cede is handled 
as an interrupt (See INTERRUPT 
HANDLING). 

• CC = 2 — The condition code is set to 
two and control is returned to the 
supervisor at four past GPRS. 

• CC = 3 — The condition code is pcsted 
in the TECB and the bit to accept 
subsequent interrupts is set. Event 
complete and interrupt occurred are 
posted in the device table. CE and DE 
are set in the CSW status, the 
condition code is set to one, and 
control is returned to the supervisor 
at four past GPRS. 

In all cases where a ccnditicn code is 
posted, if the TECE is full, the counter is 
updated and no posting occurs. If the 
counter is also full, no posting occurs . 

When all entries in the device table 
have been processed, a check is made to 
determine if this was a SIO or an 
interrupt. If an interrupt, OLTEP returns 
to the supervisor at the return register 
address and the interrupt is processed. If 
a SIO, a check is made to determine if the 
device is shared, in which case OLTEP 
issues the SIC to allow monitoring the 
result. The mcnitcring is dene to prevent 
OLTEP 's erroneous recording of supervisor 
data in the TECE, should the supervisor SIO 
be successful (condition cede 2 or 
condition code 1 with busy bit on in 
status). Return is then tc the supervisor 
at four past the return pcint so as to skip 
over the SIO that OLTEP has in fact 
executed. If the supervisor SIO is a 
success OLTEP steps through the device 
table turning off the $ACCINT flag in each 
entry where the unit address matches the 
SIC device address, and finally returns to 
the supervisor at four past the return 
point to skip the SIO instructions OLTEP 
executed fcr the supervisor. 



Interrupt Handling 



When an active device is found in the table 
and it is an interrupt passtack rather than 
a SIO, the module determines if a good SIO 
has occurred. If it has net, the rest of 
the table is searched. When no devices are 
active that require pcsting, the supervisor 
is returned via GPRS. When a good match is 
found, the CSW status is check for CUE 
alone. (This status checking is done for 
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SIO CCl and for interrupt status. If it is 
for SIO^ the return is tc four past GPR5 
rather than zero past GPRS.) If CUE is 
founds control is returned tc the 
supervisor via GPR5. Otherwise^ the 
interrupt occurred bit is set and the 
$POSTPIB routine in coirircn is executed. 
Then the CSW is posted in the 1ECB and the 
interrupt occurred bit is set. If unit 
check is on in the status, a sense is 
issued and the sense data pcsted in the 
TECB. Event complete is also turned on, 
unit check is turned off, and CE and DE are 
turned on in the CST^. If DE is present in 
the status, the device end occurred and 
device end bits are set for PiAIlIO. Event 
complete is also turned en unless ATTK=lfES 
^as specified in EXIO. In this case, event 
complete is posted on the first interrupt 
after device end. 

Before returning tc the supervisor, a 
check is made for prograir check, protection 
check, channel data check, channel control 
check, interface control check, and chaning 
check. Any bit that is en is turned off 
and CE and DE are turned on in the CS^. 

After status checking is conplete, 
control is returned to the supervisor via 
GPRS for interrupts and four past GPRS on 
SIO (after setting the SIO condition code 
with a SPM) . 



CSECT UZAD094; External Interrupt Handler 



identify the device that caused the 
interrupt. If no entry is fcund in the 
device table or if an entry is found and 
the device is not active, a return is made 
to the DCS supervisor via GPRS. Otherwise 
the old interrupt code pcrticn of the old 
external PSW is stored in the TECB 
associated with the I/O request, and 
control returns tc the supervisor via GPR7- 



CSECT IJZAINIT: Initializer 



OBJECTIVE; this ircdule indicates to the 
operating system that CLTEP is active. It 
determines that SYSLST is assigned to a 
tape drive or a printer. If it is not, 
message E230I is issued tc SYSLOG and OLTEP 
is cancelled. If SYSLST is properly 
assigned, message E10 2I(CLTS RUNNING) is 
issued tc SYSLST and SYSLOG. A system 
macro is also issued tc determine if OLTEP 
is running in real or virtual mode. If 
OLTEP has been initiated in virtual mcde, 
message E24SI is issued and CLTEP is 
cancelled. This module alsc checks tc 
deteririne that the partition size is at 
least 14K; if it is net, message E232I is 
issued and CLTEP is cancelled. Once it has 
been determined that OLTEP can run, warning 
message E13m is issued tc irfcrm the 
operator that a EASD volume labelled "CE 
PACK" may have data destroyed if an OLT is 
executed against it. Then initializaticn 
is performed and module IJZAE052 is called. 

ENTRY POINT: Label EPZADOLT. 



OBJECTIVES : Receive control from DOS \ihen 
an external interrupt occurs. Post the 
interrupt in the test section TECB if it 
has an I/O operation active en the device. 

ENTRY POINT : Label EPZAD094. 

EXIT : Return to DOS Supervisor via GPRS. 

EXTERNAL ROUTINES : $POSTPIB 

INPUT: 



EXIT: Normal — IJZAD0S2 (Communications 
Interval) . 

Errcr-~ECJ macrc. 

EXTERNAL R CUTIN ES : 

• $$BOLTEP--tc set the OLTEP bit in the 
supervisor. 

• $$BBYSWR — to deactivate system file 
protect. 

INPUT: Ncne. 



External Interrupt cede in low core 
location 134. 
Device table. 



OUTPUT: Kessages E102I E232I, E134I, 
E245I, E265I, and E230I. GPR2 points to 
the common area. 



OUTPUT: Old external PS^ Interrupt Code is KETHOD: If a decision is made that OLTEP 

can run, the Initializer module (IJZAINIT) 



stored in TECB. 

METHOD : Upon entry to the module, standard 
linkage is performed to save the caller's 
registers. Next, the old external PSW is 
examined to pick up the interrupt code, 
which is used to search the device table 
for the external signal mask which matches 
the last byte of the interrupt code to 



Establishes Register 2 as the base to 

common. 

Sets a bit if a ccrscle is available. 

Sets a bit if SYSLST= SYSLOG. 

Prints message E102I. 

Defines cere image reccrd length. 

Sees if card input is required. 
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• Sets-up operator coirimni cation s. 

• Calls $$BOLIEP to shew OIIEP is active, 

• Puts address of $IHONDLE routine in 
OLTEP address table in supervisor . 

• If MICR support is on system, puts 
address of IJZAD094 (External Interrupt 
Handler) in OLIEP address table in 
supervisor. 

• Gets CPU model number. 

• Gets 1 second BCI count, 

• Calculates high address and length of 
partition. 

• Calculates size of OLT area in 
fullv^ords. 

• Finds out if any CDS's are present. 

• Sees if timer is available and ^i^orking. 

It then exits to module IJZAD052. 



4. IJZADC33: If neither the DEV nor TEST 
entry is used, and to issue message 
E107I. 

5. IJZADC76, PEI Initialize #1: If REI 
is entered. 

6. IJZADC78, EEI Terninate: If STOPREI 
is entered. 

7. IJZADC71, Prompt furcticn. 

8. IJZADCOO, scheduler: If an OLT is 
active and EQU or a device change is 
entered. 

9. IJZADC4 9, Eguates If an OLT is not 
active and ECU is entered. 

INPUT: The reply fron the message 



UZAD052: 



Communication Interval Chart AE 



OBJECTIVE : Communicate between operator, 
remote specialist, and OLTEP fcr the 
purpose of defining, changing, or 
terminating the testing seguence, or 
entering an OLTEP verb. 



ENTRY POINT: EPZAD052. 



EXIT: 



1. A system EOJ is issued en a CAIMCEI 
request. 

2. IJZi^E031: If the DEV entry is used. 

3. IJZAD032: If no DEV entry and a TEST 
entr^' is used. 



01E105D ENTER DEV/TEST/CPT 

or control statement if card input is used. 

CUT PUT: Pointers to slashes. Messages 
E106I, E105D, E161I, E166I, E170I, E199D, 
E226I, E242I, and E250I. 

EXTERNAL ROUTINES : 

1. CECCK (IJZAD037) tc issue messages. 

2. PDUKP macro to dump OLTs partition. 

3. Option decode (IJZi^E033) is called to 
format and issue nessage E107I and 
E327I. 

METHOD : If the "options are" message has 
not been issued, exit tc IJZAE033 which 
issues message E107I. Otherwise, determine 
the source of input or need tc terminate 
pex chdrt belcw: 



~T — 
I 



ON SITE IN CONTROL 

^ 



I 

-4 



REMOTE 



TYPE OF 1 CARD | | | 
COMMUNICATION INTERVAL | SPECIFIED | NC CONSOLE | CONSOLE | IN CONTROL 
. + ^ 1 1 4 

INITIAL 1 CARD | CARD j CONSOLE j N/A 
+ + 1 ^ 

1 1 TERMINATE | | 
FIRST ERROR | CONSOLE | OLTEP | CONSOLE | REMOTE 


ON-SITE 1 1 TERMINATE | | 
INTERRUPT 1 CONSOLE | OLTEP | CONSOLE | N/A 

REMOTE II II 
INTERRUPT 1 N/A | N/A | N/A | REMOTE 



^ ^ + 



I END OF TEST 

L 



CARD 



CARD 



.+ 4 

I CONSOLE I REMOTE 

-JL L 
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Acceptable operator entries and resultant 
actions taken are as fellows: 



\ibether or not the EEV cr TEST entry is 
used. 



Operator 
Entry 



CANCEL 
DUMP 

EQU 

PROMPT XXX 



EEV/TEST/OPT 



REI 

STOPREI 
TALK 



Action Taken 



A systeir EOJ is issued. 

OLTEP and the OLT area 
are duirped en the SYSLST 
device. 

Teririnate any active CIT 
and exit to Equate module 
(IJZAD0 49). 

Exits tc the prompt 
module requested which 
prints examples of the 
device, test, or option 
entries. 

Check tc determine if 
three slashes were 
entered. If not, an 
error message prints and 
the E105D message is 
reissued- 

Exit tc the REI 
Initialize #1 module 
(IJZAD076). 

Exit tc the REI Te:cminate 
module (IJZADOIS). 

Signifies dynamic CE 
comiruni cations is 
requested. 



If this is the initial DEV/TEST/OPT 
entry, a test is made tc determine if the 
device and test are specified. If not, an 
error message prints, and the 01E105D 
message is reissued. If both device and 
test were specified, the device decode 
module is called, and the fields are 
checked for validity. The device decode 
module exits to the test decode module to 
determine the tests to be ruin. The test 
decode module exits to the option decode 
module to determine the cpticns to select. 
If there are any invalid entries in any 
field, this miodule is reentered at label 
UZAE052, and the 01E105D message is issued 
again. If all the entries were valid, the 
option decode module exits tc the scheduler 
(IJZADOOO). 

If this is not the first entry, any or 
all fields can be omitted. Entries made in 
the previous test definition are used in 
place of omitted entries. If a field is 
not present, its corresponding decode 
module is not entered, except for the 
option decode module, which is entered 



IJZADC57: Restore Label Routine Chart AG 



CBJECTIVE: 



This module is called to write 



latles on any standard labeled tapes that 
were used in testing, if either all tests 
have been run on all devices, cr testing 
has been terminated early for some reason. 
(When SCSPE is the active OLT, tape labels 
are not written.) This nodule also 
disables all enabled TP lines. 

ENTRY POIKT: EPZAE057. 

EXIT : Return to caller via GPR14. 

EXTERNAL ROUTINES : 

1. CECCM (IJZAE037) . 

2. CONVERT (IJZAE041). 

INPUT: The device entry table in the 
common area is used as the information 
soisrce. 

OUTPUT: Messages: E137I, E139E, E17^I, 
E199I, E414I. 

Updated device entry table. 



METHOD: 



This module searches the device 



table for tape entries with the standard 
label bit en, and writes a standard label 
with the same volume serial number that it 
had when the test started unless the active 
OLT is SOSPE. If the device entry does not 
have the standard label bit en, the next 
device (if there is one) undergoes the same 
test. If an entry is found with the 
standard label bit on, the previous status 
for that device is cleared and a sense is 
performed. The module then checks to 
determine if the device is file prcteeted 
or if intervention is required. If either 
condition exists, an infcrmaticn message is 
issued. If the tape is net file protected 
(ring in) cr intervention is not required, 
the tape is rewound, the label is written, 
and pointers are updated. If the writing 
of the tape label is unsuccessful, the 
module issues message E174I which indicates 
that the label was net written. A test is 
then made to determine if Unit Check (UC) 
occurred. If Unit Check did occur, the 
sense data is formatted and appended to the 
E137I message. In either case, message 
E137I is printed if a ccnsele is available. 
If a console is not available, the next 
device is tested. If message E137I was 
printed, then message E139E is issued 
requesting to bypass cr retry writing the 
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label. If b]^pass is specified, the 
pointers are updated tc the next device- 
If the retr^ option is entered, a sense is 
performed and an atteirpt is irade to ^rite 
the label. 

Message E199B is issued if a valid 
option is not selected. This indicates 
that an incorrect reply was irade and that a 
valid reply is needed. Each time the 
device pointers are updated, a test is made 
to determine if the last device has been 
encountered. After the last device entry 
has been tested, a check is made to see if 
line connection has been invcked. If it 
has, message E414I is issued and all 
enabled lines are disabled. In either 
case, control is returned to the caller. 



IJZAE031: Eevice Decode Chart AH 



OBJECTIVE ; Decode the data entered in the 
device field of the test definition. 
Checks availability of the devices and CDS 
information. 



ENTRY ; 



EXITS: 



EPZAD031. 



1. Test decode (IJZAD0 32). 

2. Communications interval (IJZAD052) , if 
there is an error. 



E108I, EllOI, ElllI, E127I, E161I, E165I, 
E234I, E235I, E251I, and E252I. 

FETHCD: If response is from remote, the 
field is checked fcr •NER. If it is •NDR, 
IJZADC57 is invcked tc write tape labels 
and/or disable TP lines. Upcn return from 
IJZADCST if •NER is fcllcwed by a slash (/), 
appropriate switches are set and central is 
^passed tc IJZAEC32. If the entry is net 
•NDR, an error message is issued and 
control is passed to IJZADC52. 

If response is not frcE remote, IJZAD057 is 
invoked tc write tape labels and/cr disable 
TP lines. Upcn return from IJZAE057, if 
the entry is •NER fcllcwed ty a slash (/), 
exit is made tc IJZAE032. If -ISIER is not 
followed by a slash, an errcr message is 
issued and control is passed tc IJZAE052. 
If entry is net "NER, the field is scanned 
for one of the following types (mixed types 
not allowed) : 

1. A symbclic name cf frcm 1-8 
characters, the first cf which must te 
A~Z, #, $, cr a, fcllcwed by a slash 
or a comma (indicates another symbclic 
name fellows). 

2. A three- cr four-digit numeric unit 
address followed by cne cf the 
following: 

a. Slash. End of device field. 

b. Dash. Another three cr four-digit 
numeric fellows defining a range of 
devices. 

c. Ccmma. Another three cr four-digit 
numeric device address follows. 



EXTERNAL ROUTINES ; 

1. CONVERT (IJZADCiJl), tc ccnveil the 
entry from EBCDIC tc hex. 

2. GETCONEG (IJZAD016) , to access the 
configuration data set (CDS) . 

3. CECOM (IJZAD0 37). 

4. Restore tape labels (IJZAD057). 

INPUT ; Reply to message 

01E10 5D ENTER DEV/TEST/OPT/ or, control 
statement if card input is used. 

OUTPUT; Device addresses and/or symbolic 
names are put into the device entry table 
along with CES information. Messages: 



K cte ; Up to 16 device entries are 
accepted. 

If one cf the above is net found, 
appropriate error messages are issued and 
exit to IJZAEC52 is taken. Hex each device 
specified, IJZAEC16 is invcked to obtain 
CDS informaticn which is used to build the 
device table entry. A check is also made 
to assiare that the device is assigned tc 
the background and, if POWER is active, 
that device is not subject tc spooling. If 
CDS informaticn is not available or the 
device is not assigned, cr if the device is 
subject tc spccling by POWER, an error 
message is issued and scan of input 
continues. When a slash '/' is 
encountered, if at least cne device is 
available fcr testing exit is tc IJZAE032. 
Otherwise an appropriate message is issued 
and exit is tc IJZAD052. 
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IJZAEQ32; lest Decode Chart AK 

OBJECTIVE : Decode the data entered in the 
test field, build a test table, and set 
routine bits in SCI. 

ENTRY PQINl : Label EPZAD032. 

EXITS ; 

1. Option Decode (IJZAD033). 

2- Coirirunications Interval CIJZAD052) on 
an error condition. 

EXTERNAL ROUTINE ; CECOM (IJZAD037) to 
output iressages. 

INPUT ; Reply to message 

01E10 5E ENTER DEV/TEST/OPT/ or, control 
stateirent if card input is used 

OUTPUT: 

• Routine bits set in SCT. 

• Section IDs in the test table. 

• Highest routine naire in ccminon. 

• Messages: E112I, E155I, E161I, and 
E170I. 



b. Cne to three alphabetic characters. 
Indicates a test secticn to be run 
fcllcwed by; 



METHOD: 



A test is made en the first entry 



flag, then the inforiraticn entered after 
the first slash is checked fcr: 

1. Slash. Indicates use of the Siame 
tests as indicated in the previous 
test run definition (invalid on first 
request) . 

2. A test is made to deteririne if the 
entry is a valid SOSP name (TSOSPB/ or 
SOSPB/). 

3. Alphabetic character. A test is made 
to determine if the first character is 
alphabetic. If so, the test field is 
checked for a valid alphabetic prefix 
(N, P, R, or T). 

Note: If entry contains a valid 
prefix, the next four characters are 
checked. A four-digit numeric 
following in this pcsiticn denotes 
test type. 

4. Eour digit numeric. Indicating the 
test type and followed by: 

a. Slash. Indicates run of all 

available test within section range 
A-Z. 



(1) Slash. 



End cf test field. 



(2) Dash. Another cne to three 
alphabetic characters follows 
tc establish a range of test 
sections tc run. The second 
cne to three alphabetic 
characters can be followed by: 

(a) Slash. End cf test field. 

(b) Comma. Another one tc 
three alphabetic characters 
designating another test 
secticn tc run. 



(3) Ccmma. Indicates additional 
test field entries follow. 
These can be : 

(a) Alphabetic character (s) . 
Another test secticn tc run 
(up tc 26 cne to three 

character entries separated 
by commas are accepted) 

(b) Numeric character. Routine 
in the secticn immediately 
preceding the comma is to 
be run. This can be 
followed by; 

- (Dash) . Another numeric 
character fellows 
designating a range of 
routines tc be run (must 
not exceed 255) . 

, (Comma) - Another numeric 
character fellows 
designating another routine 
within the section to be 
run. 

Notes: Where routines are requested, 
only cne test secticn is allowed in 
the test field entry. Finally, the 
program checks tc ensure that the 
field is terminated by a slash. A 
mask cf X*FF* is set after the last 
entry to mark the end cf the test 
table. The device initial entry 
switch is reset in this mcdule. A 
valid section entry can be up to three 
alphabetics (ZZZ) . When a range is 
indicated by two values separated by a 
dash, the second value must be greater 
than the first. If any of the 
preceding rules are violated, an error 
message is issued and centrol is 
passed tc IJZAD052. Otherwise, exit 
is to Opticn Decode (IJZAD033). 
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IJZAD033: Option Decode Chart AN 



2. Alphabetic characters represent the 
options: 



OBJECTIVE : Decode the data in the option 
field, sets option switches accordingly, 
and/or fcrniats message E107I. 



ENTRY POINT: Label EPZADOBB. 



EXITS: 



Noririal. 

1, MZABOOO, or the en line test in 
progress. The prcgrair checks to 
deterirdne if this is a ccmmxinication 
interval during the execution of an 
OLT and that neither a device change 
nor test change is desired. If 
these conditions are iret, control is 
given to the interrupted OLT. 
Otherwise, exit is to the scheduler. 

2. IJZAD052 after printing E107I and 
E327I. 



Error. When an invalid entry is found, 
the appropriate iressage is issued. 
Control is given to IJZAD052. 



"""""""" 


""*" ■"" "" 


-T T 


TL 


Cva lue ) 


1 NTL 

1 

1 

1 


Test loop; 
defaults to 10, 
iraxiiruip value is 
32,767. 


EL 


(value) 


1 NEL 

1 

1 


Error loop; 
defaults to value 
specified in OLT. 


EP 




1 NIP 


Error print 


CP 




1 NCP 


Ccntrcl print 


PP 


(x) 


1 NPP 
1 


(where x=level 
0,1,2 or 3) 
Parallel print 


FE 




1 NEE 
1 


First error 
cciriruni cation 


1^1 




1 NWI 


Manual 
intervention 


PR 




1 NPR 


Print 


RE 




1 NRE 


Reircte 


TR 




1 NTR 


Trace 


— .— — 


. 


,. 1 1 



EXT= 
Fcllcwed by up t 
which are placed 
adjacent to the 
CLTEP nucleus, 
entered last in 



c 54 characters, 

in an area 
PASSCN area of the 
EXT= irust he 
cpticn field. 



Coitiras I Separating the 
I options. 



f 



f 



EXTERNAL ROUTINE: CECOM (IJZAD037). 



INPUT : Reply to message 

01E105D ENTER DEVVTEST/OPT/ or, control 
statement if card input is used. 



OUTPUT : 



1. Option bits in SCT. 



Messages ; 
E327I. 



E107I, E115I, E161I, E176I, 



METHOD : This module is entered to either 
format the E107I message or decode the 
contents of the option field at test 
definition time. If entered to format the 
E107I message, no option switches are 
altered. If entered with option field 
entry, the m.odule checks the information 
entered in the option field for: 

1. Slash. Indicates nc options are being 
altered. In the initial test run, the 
default options are supplied. 
Thereafter, unspecified options are 
not modified. 



This ircdule ccirpares the last two 
characters of each cpticn in the option 
field with an entry ir a tatle of all 
options. When a iratch is fcund, a 
corresponding entry is selected from one 
of two tables cf instructions depending on 
whether or not the option was preceeded ty 
the character "N". The entry in this 
second table is now the target of an 
EXECUTE instruction. The table entries 
executed are CI, NI or EAL type 
instructions. The first two types of 
instruction, when selected, perform the 
function of setting or resetting the 
option flags. A return is then made to 
the instruction following the EXECUTE 
instruction. The third type instruction 
(BAD allcws linking to sutroutines which 
perform further decoding of value fields 
(for TL, EL and PP) . When the processing 
of the value field is ccmplete, the next 
entr^ in the option field is selected. 
The EXT= entry is the cnly cpticn which 
does not follow the abcve rule. The field 
between the EXT= and the last / will be 
placed in the EXT buffer f cllcwing a one 
byte count cf the number cf EXT characters 
entered. All trailing unused bytes are 
zeroed. If EXT=/ is entered the entire 
buffer is zeroed. This allcws the 
operator to clear the EXT field. 
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Notes : The test and option initial 
entry switches are reset in this 
module. If a slash occurs in the 
option field, the default values are 
used on the initial entry. Ml and RE 
are irutually exclusive options and, if 
selected together, as with all other 
errors, a message is printed and 
control is passed tc the 
Coirirunications Interval module 
(IJZAD052). 



IJZAEOOO; 



Scheduler Chart AP 



OBJECTIVE: Schedule tests against devices 
using a device table and test table. 
Also, to loop through these tables if the 
test loop option has been specified. 

ENTRY POINT : EPZADOOO (byte 2 of 
parameter list, pointed to by GPRl, vvill 
determine what routine will be executed). 



EXIT, NORMAL : 



The OLT entry point 
Communication interval 
(IJZAD052) 

REI Initializer (I0ZADC77) 
$$BTOLTP 

READD (IJZAD024) 
Data protect (IJZAD056) 
l^UATE (IJZAD04 9) 



EXIT^ ERROR : None • 



EXTERNAL ROUTINES; 



Data protect 
(IJZAD056) 
READD (IJZAD024) 
CONVERT CiaZAD041) 
CECOM (IJZAD037) 
Communication interval 
CIJZAD0 52) 
REI (IJZAD077) 
$$BTOLTP 



INPUT: GPRO contains the return code. 

GPRl contains parameter list 

address. 

GPR2 contains base address of 

common 

Parameter list contains: 
Byte — Transient manager flags 
Byte 1 — Action value (routine 
to be executed) 
Value - AOOCIEAR - 
reset all pointers and 
begin scheduling. 
Value 1 - AOOTERK - 
terminate active CIT, 
continue scheduling. 



Value 2 - AOOETERM - 
normal return from OLT. 
Value 3 - AOOIOERR - 
CECGNl called for reply 
by CLTEP with no 
console. Cancel active 
OLT cr continue 
scheduling next device 
if EC OLT is active. 
Value 4 - AOOOCNTR - 
return from old OLI 
because CLT could not 
test primary device. 
Value 5 - AOOEPRET ~ 
normal return from data 
prctecticn- 
Value 6 - AOOREREI - 
normal return from 
REAEE tc flush cards 
Byte 2 and 3 — Bdcdule IE 

OUTPUT: Messages E117I, E127I, E158I, 
E198I, E201I, E227I, E231I, E238I, E239I, 
E501I. 

KETHCD: The scheduling is performed by a 
triple nested loop. The cuter loop is the 
•test loop* option counts, the middle Icop 
is the device Iccp, and the inner locp is 
the test locp. The cuter Iccp starts by 
clearing flags that may have teen set, 
such as the 'Einal' fcr a test, and it 
sets up the family nane cf the tests tc he 
run. The middle locp sets up the SCT for 
the device that is being scheduled fcr 
test. If the "Not Primary" bit is off, 
the device is considered able to he 
selected. A call tc data protection is 
the final operation tc get a device ready 
for use by an CLT. If the device passes 
data protection, it is marked as primary 
and the inner loop is entered. If the 
final bit is en fcr that section cr if the 
section does net exist, the test is 
bypassed. It is alsc bypassed if the root 
module will net fit, cr if the SCT level 
is higher than that which is supported, or 
if the test cannot run en the current 
primary device. If ncne cf these 
conditions exist, m.essage E158I is printed 
and the CLT is entered. Upon termination 
of the CLT, the remainder cf any REAED 
data set active is flushed and OLT CCBs 
are pursed. If all selected routines were 
not run, message E198I is issued. If REI 
is initializing, the scheduler exits to 
module IJZAEC77. If CLTEP is in cleanup, 
the scheduler returns tc $$BTOLTP. All 
tests entered and all devices are stepped 
through in this manner. 

If Equate is requested while an OLT is 
active the CLT is terminated and the 
Equate module (IJZAE049) is called. 
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IJZAE056J 



Eata Protecticn (General) 



Chart AS 



OBJECTIVE ; Beteritiine device type, check 
ready status, and call apprcpriate 
specific ircdule for further data 
protection. 

ENTRY POINT : EPZAD056. 

EXITS : 

1. Eata protection irodule for tape 
(IJZABO03). 

2. Eata protection irodule for DASD other 
than 2321 (IJZADO07) . 

3. Eata protection irodule for 2321 
(IJZAEO02). 

4. Caller if unit record or TP device 
(UZAE021 or IJZADOOO) . 



The data prctecticn ircdules ccirirunicate 
\fvith the Scheduler and the GKAB irodule ty 
setting t\wo bits in the device tatle. 

1. Data protection tit: 

• OFF indicates testing of this 
device irust be bypassed. 

• CN indicates the device meets data 
protection requireirents. 

2. File protect bit: 

• CFF. Full testing can be done en 
this device if data protection tit 
is CN. 

• CK. Test can crly be run in file 
protect ircde. 



These bits are reset by the restore 
labels routine (IJZAEC57) . 



EXTERNAL ROUTINES : 



1. Convert module (IJZAD0 41) to convert 
binary data to EBCDIC before 
printing. 

2. CECOM (IJZAD037) for conmunioations. 

INPUT: R8 points to entry in device table 
for device to be data protected. 

OUTPUT: Messages: E130I, E137I, E138I, 
E139E, 04E113B, 04E139D, and 04E199D. 



IJZADC02: 



Chart AU 

OBJECTIVE: Prctecticr. of customer data 
\while allowing effective testing of the 
IBl^ 2321. 

ENTRY JPCIOT: EPZAEO02. 

EXIT: Return to caller via R14. 



MET HOE ; If the device to be tested is a 
System/ 1 , message 04E113D is issued. If 
the reply is "yes", the caller is rettirned 
with the data protection flag on; 
otherwise the caller is returned with the 
data protection flag off. If the device 
to be tested is shared (assigned to both 
background and foreground) , a bit in the 
device table is set to indicate that 
testing can only proceed in file protect 
mode. If the device belongs exclusively 
to the background, full testing can be 
performed, provided that it fulfills all 
other data protection requirements. 

The next check is for ready status. 
This is the only data protection task 
required for unit record or TP devices, 
because input/output for these devices is 
external and pertains only to a particular 
test section with no exposure to 
destruction of permanent data. If the 
device being tested is a tape, iaZADO03 is 
entered. If 2321, IJZADO02 is entered. 
If the device is a DASD and not a 2321, 
IJZAEO07 is entered. 



EXTERNAL ROUTINE : 

1. CECCK (IJZAE037) fcr two-way 
coirirunications . and iressageSa 

2. CONVERT (IJZAE041) tc convert hex 
data tc EECEIC before printing. 

IM^T; R8 is a pointer tc entry in the 
device entry table. 

OUTPUT: jvessages: E126I, E130I, E131I, 
E132I, E137I, E139E, E199E. 

METHOD; If the current test section is 
section "T," return tc the caller with 
testing allowed in file protect mode 
(FPM) , otherwise, a sense ccmmand is 
issued first to bin 0, subcell 18, then tc 
bin 0, subcell 19. The CE bit should turn 
ON when siJbcell 18 is sensed to indicate 
that a CE cell is mounted. The bit should 
reset when the sense to subcell 19 is 
made. If both sense commands are 
successful, caller is reentered, and 
testing is allowed in file protect mode 
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(FPM) for sections S, U, or V. For all 
other sections, testing continues in 
non-file protect rrode. 

Any failure in the sense canmands 
causes the printing of a iressage 
indicating the failure, followed by the 
sense and CSW infornaticn. A message is 
then issued giving the operator the option 
either to bypass the test or to mount 
another cell and retry the data 
protection. 



04E139E BEPLY E TC EYFASS,R TO 
PITRY,P TC PRCCllE (MAY 
EESTROY DATA) 

A bypass reply causes a return to the 
calling nodule, A retry reply causes the 
data protection checks (except the ready 
check) to repeat. A proceed reply allows 
the tape to be used for testing. 

If the security bit in the label 
indicates the voluire is security 
protected, the followirg iressages are 
issued: 



I JZAEO0 3: Data Protection, Tapes, 
Chart AV 



OBJECTIVE : Protect customer data ^^hile 
allo\^dng effective testing cf tape 
devices . 



ENTRY POINT: EPZADO03. 



EXIT: 



Return to caller via R14, 



E122I VCL ON XXXX SECURITY PROTECTEE 

04E139E REPLY B TC EYPASS,R TO RETRY 

The bypass reply causes a return to the 
calling module. The retry reply causes 
the data protection checks to repeat. 

If the expiration date has not expired, 
the fcllcwing messages are issued: 

E122I VCL ON XXXX UNEXFIREE EATE 

04E139E REPLY E TC EYPASS, R TO 
RETRY, P TC PRCCEEE (MAY 
EESTROY LATA) 



EXTERNAL ROUTINES : 

1. CECOM (IJZAD037) for two-way 
communications, and messages. 

2. Conveirt (IJZAD0 41) to convert binary 
data to EBCDIC before printing. 

INPUT: R8 is a pointer to device entry. 

OUTPUT : Messages: E118I, E119I, E122I, 
E137I, E139E, E199D. 



If all the data protection measures are 
met or the proceed reply was given in 
response to the 04E139E message, the 
volurre serial number is saved and control 
is returned to the caller. If a standard 
label was on the tape, a standard label 
with the previous volume serial is written 
by IJZADCS? at test coEpleticn. 



METHOE: Eull testing is allowed on tape 
devices if a standard labeled tape is 
moxmted, volume security protection is not 
specified, and the expiration date has 
expired. The standard label can be either 
EBCDIC or ASCII. Volume security is not 
specified if byte 11 of VOLl label is not 
for an: 

• EBCDIC label of hex '40', 'FO', or 
•00* and for an 

• ASCII label of hex »20', '30*, or 
•00". 

If the tape label is unreadable, the 
following messages print: 

E118I UNREADABLE TAPE LABEI-XXXX 

E137I CSW XXYYYYYYYYYYYYYY SNS 

Jn.J\ s • a Jn.^ 



IJZADC07; Data Protection, EASE (otter 

than 2321) Chart AX 



OBJECTIVE: Protect customer data while 
allowing effective testing cf the DASD 
other than 2321. 

ENTRY PCIKT : EPZ ADOO 7 . 

EXIT: Return to caller via R14. 



EXTERN AL ROUTINE S : 

1. CECCK (IJZAE037) for two-way 
communications, and messages. 

2. Convert (IJZAE041) to convert binary 
data to EECEIC for printing. 
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INPUT: R8 points to device entry. 

OUTPUT: Messages: E122I, E124I, 321251, 
E137I, E139E, E199D. 



METHOD : If the device is a ncn- shared 
3330 Twith the CE bit en in the home 
address, the caller is returned to viith 
testing allowed in non-file protect mode. 
If the device is a shared 3330 with the CE 
bit on in the home address, the caller is 
returned to with testing allowed in file 
protect mode. For non-shared 2314 and 
2311 drives, cylinder 6, track 0, record 
is read and checked for a FOFE. This 
indicates a CE volume and allows testing 
to proceed in non-file protect mode. 
When FOFE is not found or the pack is 
not a 2311 or 2314, an attempt is 
made to read the volume label and home 
address. (If unsuccessful, there will te 
up to ten retries.) A check is made for a 
standard label (Volume 1) . If a volume 
has a standard label and the volume 
security indicator is net X'FO', X'OO", or 
X"40' the volume is considered secure; GIT 
accessing will not be allowed; and message 
E122I is issued. If the pack has a volume 
serial number of CEPACK and is neither 



security protected nor shared, testing is 
allowed to proceed in nen-file protect 
mode. If the pack has a volume serial 
numsber of CEPACK and is net security 
protected but is shared, testing proceeds 
in file prefect mode. If a pack has a 
standard label, but dees net have a volume 
serial number ef CEPACK and is not 
security protected, message F124I is 
issued and the file protect mode bit in 
the device table is set indicating that 
testing can proceed ir file protect Eode. 
If a volume dees not have a standard 
label, message E125I is issued. whenever 
messages E122I, E125I, and/cr E124I are 
issued, message E139E fellows giving the 
operator the fcllcwing three epticns : 

1. BYPASS. Bypasses the testing of this 
device and returns te caller. 

2. RETRY. Reissues the read command. 

3. PRCCEEE. Returns te caller. Testing 
is restricted te File Protect Mcde 
(FPK). 

If the label was unreadable, a message 
prints giving the sense and CSVi 
information. This is followed by the 
bypass, retry, proceed message. 
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OLTEP/OLT Support Modules 



The OLTEP primary ircdules^ the OIT, or 
other support rnodules can call the support 
modules. These support modules are loaded 
into -the transient area by the transient 
manager, and entry is made into the module 
or the entry point is passed to the caller 
as requested. They perform functions such 
as printing messages, converting data from 
hexadecimal to EBCDIC, etc. A detailed 
description of each of these modules 
appears in the following sections. 



location that are in the input 
buffer. The message is translated to 
uppercase EECEIC ard given tc the 
caller. 

(Cutput) This part controls messages 
to the remote location. Because the 
input messages are buffered and are 
not handled immediately, the remote 
location must be irfcrmed if all the 
messages were net accepted. Control 
returns to the caller. 



IJZACOIO: REI Nucleus Chart BA 



OBJECTIVE ; Control REI input/output. 

ENTRY POINT : EPZADOlO — to relocate 
module. 

$REIREAD -- to read a message. 

$REIWRIT — to write a message. 



ERP"s (Error Recovery Procedures) - 
Entered from the interrupt handler. 
Under error conditions, ERP's decide 
what the next operation is that is tc 
be performed. Return is to the 
interrupt handler. 



IJZADCll: TP Line Ccr recti en Chart AY 



EXIT: 



Return to caller. 



INPUT: Messages frcm the remote location. 

OUTPUT : CECOM and DPRINT messages to the 
remote location. 

OLTEP messages El 6 71 and E2ail. 



OBJECTIVE: Performs line connection 
function for a remote teleproeessing test. 

ENTRY PCIKT: EPZADOll. 

EXIT: Return to caller. 



METHOD ; This module is comprised of five 
parts : 

1. This part is used cnly tc relocate A 
and V type adccns. Because CITEP can 
load the module at any address, the 
value for the constants cannot be 
defined until the module is loaded. 
An address is returned to the caller 
that serves as a base register when 
other miOdules require functions of 
the REI nucleus. 

2. This part of the REI nucleus is the 
Interrupt Handler. Its address is 
put into the CCB, and DOS passes 
control to it when an interrupt is 
encountered* It determines from the 
CSW and sense information which CCW 
string is to be executed next. This 
information is then passed to the 
supervisor, or the CCB is posted. If 
CSW status is not channel end and 
device end, ERP's are called. Return 
is to the caller. 

3. (Input) This part of the REI nucleus 
retrieves messages frcm the remote 



EXTERNAL ROUTINES : CECOM (IJZAB037) 



IKPUT: 



CUTPUT: 



R3 points to EXIC parameter list. 
R8 points to device table. 



1. Return cedes: 

00 = Line connection successful. 
14 = Line connection net performed. 

2. Messages: E400I through E410I, and 
E412I through E413E. 

METHOD ; Line ccnnecticn is attempted by 
executing a channel program which is 
dynamically built based en information 
contained in the CDS. If the line 
connection is successful, a return code of 
X*00' is sent to EXIO and no error 
messages are issued. If there is 
insufficient or inaccurate information in 
the CDS, line connection cannot be 
performed. In this case, appropriate 
diagnostic messages are issued and an 
error return code of X*14' is returned to 
the EXIC module. If ar operator oall is 
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required, an appropriate message is 
issued to the operator. The message 
includes the required telephone number if 
the number was available in the CDS. Six 
m.inutes are allowed for the call. If the 
operator dees not ccirplete the call in the 
alloted tiire, the line connection is not 
successful and exit is tc EXIO with return 
code X'14* after issuing appropriate 
messages. An EXCP is issued tc execute 
the CCW chain- Systeir ERP's are b]/passed 
and appropriate errcr recovery procedures 
take place in the nicduleo Error 
conditions or time cut are indicated by a 
diagnostic ir.essage« In the case of time 
out^ the I/O request is purged and an 
error message code (X'14') is returned to 
the EXIO module. This indicates that line 
connection was not performed. If line 
connection is successful, the bit in the 
CDS requesting line ccnnedticn is reset 
and a return code of X'OO* is passed back 
to EXIO. i^lso, any devices en the same 
line address which had previously been 
connected are flagged as disabled. 



Kew Fcrirat local file (Phases 
IJZM000-IJZAE999) . 



Kew Fcrirat CE/Custcmer (remicte) file 
(Phases IJZiVF000-IJZE999) . 



IJZAEQ16; GEICONFG Chart BE 



OBJECTIVE ; Locate and load the desired 
Configuration Eata Set (CDS) into the 
location specified. 



ENTRY POINT : EPZAD016. 

jcAxT . jntiL-ajLii L-o v-,ci±JLejL 

EXTERNAL ROUTINES ; 

• CONVERT (IJZAD041). 

INPUT ; 



1. Buffer address, buffer size and 
address of CDS. 



OUTPUTS Return cedes: 

X'OO' = Successful ccfffleticn. 
X'04' = Function ret available. 
X'08' = Buffer full or entry size 
greater than buffer size. 
X'OC* = Kc entry found. 

KETHCB: The GETCCNFG module obtains the 
desired CES informaticr specified by the 
caller. The first action taken by this 
module is tc check the nacre level. If 
correct, processing ccrtinues. Otherwise, 
a code of X'04' is returned tc the caller. 
The module then deterirines if any CDS's 
exist in this system. If they do, 
processing ccntinues. Otherwise, a code 
of X'OC is returned tc the caller. The 
module then determines whether the new 
format CDS (CES length is variable) or the 
old format CES (256 bytes in length) is to 
be processed. This is dene by checking a 
bit in the ccrrmon area ($NE1^'CES). If the 
caller has net specified the address of a 
CDS, a default tc prinary device is 
assuired. This is done by testing the CDS 
ADDR parameter. If it is a zero, the 
default tc the primary device is desired. 
If not zero, the caller has specified a 
desired CDS. 

In the case in which the caller has 
specified a CES in the CDS AEER, a test is 
made to determine which type cf CES is 
desired. There are twc general CES's -- a 
local CDS family and a remcte or 
Custoirer/CE defined CES family. Each cf 
these twc families can be either in the 
ne^ fcrirat (each CES is condensed to its 
actual length) or the eld fcrmat (each CDS 
is 256 bytes in length. If a local CDS is 
specified (Eyte 9, Bit 6 cf that portion 
of the CDS contained 'in the device entry 
table is off), the Iccal CES phases 
(IJZAC000-IJZAC999) are searched. If a 
remote or Custcmer/CE CES is specified 
(Byte 9, Eits 4 and 6 are en), the remcte 
file CDS phases (IJZAE000-IJZAD999) are 
searched. If the new fcrirat is indicated, 
the search is the same as just stated 
except that local phases 
(iaZAE000-IJZAE999) and remcte phases 
(IJZAF000~IJZAF999) are used. 



2. Local file (Phases 
UZACO00-IJZAC999) . 



3. CE/customer (remote) file (Phases 
IJZADO00-IJZAD999) . 



In the case in which the caller has not 
specified a CES, the default is to obtain 
CDS infcriraticn for the primary device. 
The primary device car be either a Iccal 
CDS type or a remcte or Custcmer/CE CDS 
type. 
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The GETCONFG module places the name of 
the phase to be loaded into a location 
(MiTPBi^SE) within the ccirir.cn area. Then 
starting with the first, the phases of the 
CDS file are loaded into a buffer within 
this module. The fc Hewing sequence of 
testing is performted: 

A check is made to determine if the 
desired CDS is within this phase. If not, 
a check is m.ade for the keyword "NEXT" or 
"LAST". If the keyword "NEXT" is present, 
the next phase name is placed in the 
common area (ALTPHASE) and that phase of 
the CESS will be loaded and the sequence 
repeated. If "LAST" is reached without 
finding the desired CDS, a return code of 
'OC* is passed to the caller. 

The equate active bit ($EQTACT) in the 
common area is tested. If it is on, the 
EQUATE TABLE is used while searching the 
CDS entries before the normal search. If 
one is found, the unit address in the CDS 
is changed to allow the CDS to appear to 
belong to the actual device which had been 
equated (see Note). 

If the desired CDS is fcund, the buffer 
is filled with CDS data. If the buffer 
was not large enough (requiring truncation 
of the CDS data passed) a return code of 
•14' is passed to the caller. 

If the buffer was large enough, a 
return code of •00" is passed to the 
caller. 

Note ; The EQUATE FUNCTION is explained 
under UZAE049. 



IJZAD021; GRAB Chart BF 

OBJECTIVE : Perform a search of the device 
table for the device to be used as a 
secondary device by the on-line test 
section. Data protects the device and 
returns its address to the caller. 

ENTRY POINT : Label EPZAD021. 

EXITS: Returns to the calling module. 

INTERNAL ROUTINES : Data Protection 
(IJZAD056). 



X'08* = Device net fcund to satisfy 

GRAB requirements. 
X"OC" = Cnly cne device in entry list. 
X'lO' = Device descriptors not 

aval lab le- 
X"14* = CDS indicater predefined 

infcrmaticn available, but was 

not passed. 

B5ETHCD: The grab module searches the 
device table fcr a seccrdary device 
starting at the entry f cllcwing the last 
assigned secondary device, cr the entry 
following the primary device (if no 
secondary device has been assigned) . It 
scans to the end cf the table, restarts at 
the beginning until a match cr the 
starting point is fouEd. 

If there are no entries in the device 
table or if the GRAB macrc is not 
compatible with the mcdule, a code of 
X'04' is loaded into GPR15, the caller's 
registers are restored, and ccntrcl 
returns to the caller. If there is cnly 
one entry in the device table, a code of 
X'OC is loaded into GPR15, and control 
returns tc the caller. If SOSP is active, 
grabbing cf previously "grabbed* devices 
is allowed. Next, the device is checked 
against the requirements specified by the 
caller. If it doesn't match, then the 
search continues. When a device is fcund 
that meets all the specifications (and if 
the device may be grabbed) it calls data 
protection (IJZAD056) if the device has 
not been data protected and sets the grab 
bit in the device table, the pointer to 
the next device entry available fcr 
grabbing is updated ard device descriptors 
(if available) are mcved intc the caller's 
buffer alcng with the device address. A 
ret\3rn code cf X'OO' is set in GPR15, and 
control returns tc the caller- 

If data protection dees net allow the 
device tc be grabbed, then the next entry 
in the table is checked, etc until the 
whole table is searched. 

If the whole table is searched without 
finding an appropriate device, a return 
code of X'08' is loaded in GPR15 and 
control passes to the caller using 
standard linkage. 



iaZADC22: 



ALCCAT Chart EB 



INPUT : Parameter list: 



OUTPUT: Return codes: 



X'OO* = Successful grab. 

X«0 4' = Facility not available. 



OBJEC TIVE : Check tc determine if write 
testing is allcwed on a direct access 
device. 



ENTRY POINT: EPZAD022. 
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EXIT: Return to caller. 



iaZADC24: REAED Chart EJ 



EXTERNM. ROUTINES : 

1. CECOM (IJZAD037). 

2 . CONVERT ( IJZADO 41) , 

INPUT: Parameter list 



OUTPUT: 



Return Codes : 

X'OO' = Successful Allocation. 
X'0 4" = Function not available or 

device not a DASD. 
X"08" = Device net in device tatle, 

or not primary or grabbed. 
X'lO' = Space not allocated. 



Messages : 
E145D. 



04E120D, 04E199D, and 



MET HOE : The local-print- only bit is set 
so that the remote location does not get 
any of the messages. Ihe program then 
checks to determine if the macro level is 
version 2 or later. If not^ a return code 
of X'04' is put in register 15^ and 
control returns to the caller. 

The program checks the CDS address to 
determine whether to use the device 
address in the SCT or the CDS. A search 
is made (by device address) of the device 
table to locate the specified device 
entry. If not in device table, a code of 
X'08* is returned to the caller. If it is 
in the table, a check is made to determine 
if the device is a DASD. If not, a code 
of X'04" is returned to the caller unless 
there is Tin CDS for this device, ^n^ SCSP 
is the active test, in which case 
allocation proceeds. If scratch was 
specified, then the ALOCAT bit in the 
device table is reset, and a return is 
made to the caller with a X'OO* in GPR15. 
If device is not scratched, or grabbed and 
not primary, an X*08' is returned. 

If the EPM bit is OFF and if data 
protection has already been performed, the 
ALOCAT bit is turned on, and X'OO" is 
returned to the caller in GPR15. 
Otherwise, the operator is asked if the 
data on the volume may be destroyed. If 
it may, the FPM bit is turned off, the 
ALOCAT bit is turned on, the 
local-print-only bit is reset, and control 
returns to the caller with an X'OO' in 
GPR15. If data may not be destroyed or if 
the device is shared, a X"10' is returned 
to the caller in GPR15. 



OBJECTIVE; Provide for the reading of a 
record from an external data set, or flush 
the READD data set if called, when the OLT 
is not active. 



ENTR:^ PCIKT: EPZAD024. 



EXIT: 



Return to caller. 



EXTERNAL ROUTINES : 

1. CECCK (IJZAE037). 

2. CONVERT (IJZAD041). 

INPUT: Address of the device to be 
accessed. 

OUTPUT : 

1. Data that is read successfully. 

2. jyessages 04E197E, E236I, E237I and 
04E199D. 

3. Return codes: 

X'OO' = Record read satisfactorily. 
X'OU' = Facility net available. 
X'08" = Permanent error occurred 

while reading record. 
X'OC = End of data set. 
X'lO' = No reccrd found. 

METHOD: The local-print-cnly bit is set 
SO that the remote location does not get 
any of the messages. If an OLT is not 
active, the current data set is flushed. 
Otherwise, the macro level is then checked 
to determine if it is version 2 or a later 
version. If it is not, a return code of 
X"04' is put in GPR 15, and ccntxcl 
returns to the caller. The program then 
checks to determine whether card or tape 
is being used for input data. If the 
input is en card, OLTEP checks for the 
standard label (first two cards). If the 
data set resides on tape, it checks for a 
standard label. If no standard label is 
recognized, X'04' is put into register 15, 
and control returns to the unit test. 



If this is the first 
data set, message 04E19 
requesting a tape to be 
device. A 'NO' reply c 
of X'04' to be returned 
mounted, the device is 
it is net a test device 
logical unit assignment 
a test device, message 
If the device does not 
assignirent, message E23 



request for this 
7D is issued 

mounted on a free 
auses a return code 

If a tape is 
checked to insure 
and that it has a 
If the device is 
E236I is issued, 
have a logical unit 
71 is issued. 
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Next, the prograir checks the RESET and 
EACKSPACI parameters. If neither is 
active, the prograir issues an EXCP. If 
there are no errors, the data record reads 
from tape cr card and gees intc the input 
buffer area provided by the unit test. 

If an error is encountered \<?hile 
reading, control returns to the imit text 
with X'08' in register 15. 

If the RESET paraireter is active and if 
tape is the data input device, the tape is 
positioned to the beginning of the data 
set and control returns to the imit test. 
If the device is net tape, control returns 
to the unit test with X*04' in register 
15. 

If the Ei^CKSPACE is active, the program 
checks to determine if the device is tape 
or card. If card, control returns to the 
UQit test with X'04" in register 15. If 
tape is the data input device, the 
following checks are made : 

• Absence of a backspace integer results 
in the default cf cne record to te 
backspaced. 

• When the integer is frcm 1 to 255, the 
tape backspaces the number of records 
indicated by the integer. 

At end cf file, the program checks to 
determine if the data set is on tape. If 
it is, it positions the tape to the 
beginning cf the data set, the 
local-print-only bit is reset, and control 
returns to the unit test with X ' OC • in 
register 15. If the data set was not on 
tape, the local-print- cnly bit is reset, 
and control returns to the unit test with 
X'lO' in register 15. 



IJZAE026; LOGSCAN Chart BI 

OBJECTIVE : Search an error recording data 
set history tape or DOS SYSREC file for 
the next sequential recording of the 
specified record, class, cr device t^ype. 

ENTRY PO INT ; EPZAD0 26. 

EXIT: Return to caller. 

EXTERNAL ROUTINES : 

1. CONVERT (IJZAD041). 

2. CECOM (IJZAD037). 

INPUT: The parameter list passed by the 
LCGSCAN macrc through register 1 is : 

1. $LCGIEVL. Macro level. 

2. $ICGSINA. The starting address into 
read , cr the register containing the 



address cf the area into which the 
records are to be read. 

3. $LCGREC. Size cf $LCGSINA. 

4. $LCGSCLS- Eevice class (optional). 

5. $ICGSTYP. Eevice type (optional). 

6. $ICGDUAE. Eevice address. 

7. Cne byte cf flags- 
CUTPUT: 

1. Return codes: 

X*00' = Successful read. 

X'04' = Lcgscan facility cr data 

set net available. 
X'08' = Read errcr. 
X'OC" = End cf data set without 

encountering specified 

record. 
X'lO' = No record found due to 

empty data set cr record 

type net supported. 

2. Messages: 04E199E, 04E324E, 04E323D, 
E236I, E237I, E306I. 

J5ETHCD: This module provides the facility 
for CITS to obtain the output from an 
active (DCS SYSREC file) cr non-active 
(DCS or CS History tapes) errcr recording 
data set. 

This module determires which data set 
is to be accessed via the reply (ies) to 
message (s) E323E and/or E324E. This 
module then sets up identifiers to be used 
when this module is re-entered. 

If the data set chosen is the EOS 
SYSREC file (System Recorder file), the 
header record is read and the extents of 
the file are saved in CLTEP common area. 

If the data set media is tape, the 
device address is tested for a LUE 
(logical Unit Block) assignment. If a LUE 
is present, then a test is made to insure 
that the device was not a test device. If 
one of these tests failed, message E237I 
or E236I respectively would be given 
followed by message E324E. 

After the initialization process is 
complete, the first record cf the EREP 
data set is read intc the CLT buffer. 
This reccrd is tested for the specified 
record type and/or device class and/or 
unit t^pe and/or device address. If the 
record fulfilled the request, LCGSCAK will 
place the record in callers buffer and 
return to the OLT with the appropriate 
return code. If the test fails, the next 
record is read and the pointers of the 
data set are updated. 
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For the initial read, the first record 
received is always at the beginning of the 
data set. Upon re-entry the subsequent 
records are read, or if reset option is 
specified, the data set is positioned tack 
to the beginning. 



IJZAE028; PLINK Chart BM 

OBJECTIVE ; Load and/or delete modules at 
the request of the OLT section. 

ENTRY POINT ; EPZAD0 28. 

EXIT ; Return to caller (OLT). 

EXTERNAL ROUTINE ; Ncne. 

INPUT ; Parameter lists pointed to by Rl 
that contain pointers to the names of the 
modules to load and/or delete. 

OUTPUT ; 

1. List of entry points f cr modules 
loaded. 

2. Return codes; 

X'OO" = Successful. 
X"0 4' = Facility not available. 
X'08' = Error encountered. 
X'OC* = No module found 
X'lO" = No space in irain storage. 
I 3. Message E253I 

METHOD; The caller's macro expansion is 
checked for the correct level (2). If the 
level is Throng, a return code of X'04' is 
set into register 15, and control returns 
to the user. If the level is correct, the 
caller's request is examined. A request 
for a delete causes a return code of X'OO* 
to be set and control to pass back to the 
calling OLT. 

If a load is requested, the program 

-h^3-i23 -^Q cletermine if the nuirfcer of modules 
to be loaded is zero. If so, the return 
code is set to X'08"- and control returns 
to the calling OLT section. A request to 
load a module that is too large for the 
available storage causes a return code of 
X'lO* to be set before returning. A request 
to load a module that does not exist causes 
a return code of X*OC* to be set before 
returning and message E253I to be printed. 

Before loading a module, a check is made 
to see if plinking into the morecore area is 
desired. If plinking into the morecore area 
is requested by the OLT, a search is made to 
see if the module is already in the morecore 
area. If the module is already there, it is 
not reloaded; it's entry point is returned 
to the caller. If the module is not in the 
morecore area and space is available, it is 
loaded into the morecore area. If space is 



not available or plinking into the morecore 
area is not requested by the OLT, the orig- 
inal overlay structure established by the 
OLT is used. 

When the requested module is loaded, its 
entry point is placed into the caller's 
entry point list, and the return code set 
to X'OO'. Control then returns to the 
calling GIT section. The CLT section is 
responsible for making sure it doesn't 
overlay the path back tc itself. 



IJZADC35; EXIC Chart EN 



CB JgCI IVES ; Converts the test section's 
request for an I/O operation into EOS 
format. If the device is a 2321 cr file 
protect mode (FFM) , the CCW string is 
searched for data protection violations 
(vjrites, TICs outside the chain, etc.) 
Line connection for TP is performed if 
required . 

ENTBY^PCIKT; Label EPZi^C035. 

EXIT; Return tc caller via GPR14. 

EXTERNAL ROUTINE; TP line Connection 
(IJZADCll). 

INPUT; Parameter list pointed to by Rl. 
(Parameter list); TECE address CCl^ address 
and count, CES address (optional). Flag 
Byte (contains indicators to show if 
ATTNIN=YES, EUSY=YES , ard/or SENSE=NO are 
specified) . 



OUTPUT; 



Return codes: 



X'OO' = EXCP issued. 

X'04' = Facility not available. 

X'08' = Device not available or TECB 

address missing; or device not 
primary; or rot grabbed; or 
second CCE rot availatle- 

X'OC* = Er erxci: ir. CCW chdin. 

X'lO' = Processed all recuests except 
SENSE=NO. 

X'14' = Line connection requested tut 
not successful. 

MET HOD ; The program checks the macro level 
to determine if it is 2 or 3. If not, the 
caller receives control with a return code 
of X'04' . 

If CDSADR is specified, the device 
address is picked up from the caller's CDS. 
If not, it is picked up from the SCT. 

The device table is then searched by 
unit address or symbolic name until the 
right device entry is found or the end of 
the table is reached. If the device is not 
found a code of X'08' is returned to the 
caller. 
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If the correct device is located in the 
device table and, if it is already active 
or not grabbed or priirary, a code of X'08' 
is returned to the caller. A LIB pointer 
to the PUB will already be set up by the 
Eevice Decode. This establishes a 
pro grammer- logical -unit name to be 
specified in the CCB CCoiripand Control 
Block). If the device entry is flagged as 
active and a WAITIO has not been issued, a 
code of X"0 8' is returned to the caller. 
If the device is active and a WAITIO has 
been issued, a purge is required. SVC 25 
is issued and the purge bit is reset. Then 
a check is roade to deteririne if CCBl or 
CCB2 is available. If net, a code of X*08' 
is returned to the caller. If so, a 
pointer is set to the available CCB. 

The first six bytes of the CCB are 
cleared. Further checks are made to 
determine if line connection is required. 
If so, the line connection ircdule is 
called. If line connection is 
imsuccessful, a code of X*14* is passed 
back to the caller. 

Next, the program checks the 
file-protect-mode bit in the device table. 
If it is on, or if the device is a 2321, 
the CCW chain is scanned for data 
protection violations. If any are found, a 
code of X*OC* is returned to the caller. 

Next the CCB is built. The CC^ address 
and LUB assignment are ircved into the CCB. 
If ATTNIN=YES is specified, a bit is set in 
the device table. The active bit in the 
device table and a bit indicating the CCB 
in use are set. Another bit in common is 
set indicating that the CCB is in use. The 
CCW chain is then executed via the EXCP 
macro. Before returning to the caller a 
test is made to determine if SENSE=NC was 
specified. If it was, the return code is 
set to X*10*. Otherwise it is set to 
X»00». 



ENTRY POINT; Label EPZAD036. 

EXIT: Return to caller. 

EXTERNAL ROUTINES : N c ne . 

INPUT : Parameter list pointed to by Rl. 



OUTPUT: 
Return codes: 

X'00» = Event complete CWAIT=YES, 

POLlF=YES) 

DE occurred (WAIT=EE) , Purge 

dene (PURGE=YES) . 
X*04* = Function net available. 
X*08' = WAIT timed cut or polled event 

has not occurred. 
X'lO' = Polled evert occurred 
(POLL=YES) 

Interrupt occurred (WAIT=ANY) . 
X"OC* = Program, error (device not in 

table, not active, or TECB 

address is net equal to EXIO 

TECB address). 

METHOD: The functions which the caller may 
request (via the parameter list) includes: 

1. WAIT=YES — a request of this function 
causes a check for event complete. If 
it has not yet occurred, a timing loop 
is set up for the number of seconds 
specified by the caller or a default 
of 30 seconds. Within the loop an 
interrogation is itade tc determine if 
the event is complete- Return cedes 
are set as defined in OUTPUT above. 

2. POLL=YES — this causes a test to be 
performed to determine if an interrupt 
has occurred. Inmediate return to the 
CIT is effected with a return code 
issued as specified in OUTPUT above. 



WAIT=DE — this function is the same 
as WAIT=YES except that control is 
returned to the caller en the 
occurrence of DE. 



UZAD036: WAITIO Chart BP 



OBJECTIVES : Provide the facility for a 
test section to wait for any interrupt, 
device end, or completion of an I/O 
operation initiated through EXIO or to poll 
to determine if an interrupt has occurrd as 
a result of an active EXIO. 



It also provides the facilities to piarge 
an outstanding I/O request or to give up 
control for a specified minimum period of 
time. 



4. WAIT=ANY — this function is the same 
as WAIT=YES except that control is 
returned to the caller en the 
occurrence of any interrupt on the 
specified device. 

5. PURGE=YES — I/O device specified in 
the CDS is purged. 

6. TIKE=Integer (alone) — control is 
returned to the OLT when the specified 
time has elapsed. If Timer is 
available, a SETIME is used. 
Otherwise, timing is dene with a 
GETIKE loop. 
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Note ; Per items 1, 3, and 4 a SETIWE and 

WAIT are used if the tiirer is assigned to 

the background partition. The WAIT will he 

posted complete by the I/O and External 

interrupt handlers when an event is posted 

in the TICB. If the tiirer is not assigned 
to the background^ a GETIME loop is used. 



IJZAD037: CECOM Chart BQ 



OBJECTIVE : Provide coirir.uni cations between 
the unit test section COLT) cr OLTEH and 
the operator. 

ENTRY POINT : Label EPZAD037. 

EXIT : Normal: 

Return to caller. 

To IJZADOOO via $DTRMLNK (with 

action value=3) if entry is for an 

OLTEP request and SYSLOG is not a 

console. 

REI interface. 

EXTERNAL ROUTINES: IJZADOIO. 



Note; If SYSLOG is net a console 
device, two-way messages originating 
from CLTEP will result in a return to 
the scheduler at $DTRMLNK (with action 
value=3), and OLT requests will cause a 
return code of 04. 

An incciring message is read intc tbe 
operator ccmmunications buffer and 
translated to uppercase. The input must be 
R Ov,' in columns 1 through 6, where v the 
routing cede is either 1 cr 4 (when it is a 
communications interval message) cr 3 
(allowed cnly if RETAIN is active). The 
data must be followed by a single quote and 
cannot be longer than the request- If any 
of these conditions are r.ct met, message 
E175I (SYNTAX ERROR) is issued and a read 
command is issued to SYSLOG to allcw the 
operator to correct the response. If the 
routing code is 03, a bit is turned on 
telling the ccmmunications interval module 
to ignore the data. The message and its 
byte count are placed in the areas 
specified by the caller. 

For one-way com.municaticns, an iXCP is 
issued. 

All outgoing and incoming messages are 
also issued to the SYSLST device. 



INPUT : A pointer to a parameter list is 
supplied^ in GPRl, by the caller. The 
parameter list contains four byte addresses 
of: 

1. Address of the out message and its 
byte count. 

2. Address of the in message and its h^te 
count. 

3. Flags indicating one way or two way 
message. 

OUTPUT : 

1. Return codes: 

X*00» = Successful. 

X9 04' = Facility not available. 

X"08' = Error conditicn. 

2. Messages: ElOOI, 04E101D, 01E175D, 
04E175B. 

3. All OLTEP CECOM messages. 



METHOD : For two-way communications, an 
outgoing message is moved frcm the caller's 
area to the operator communications buffer, 
and its byte count is placed in the output 
CCW. All messages will have trailing 
blanks suppressed and, if an OLT message, 
an identification is prefixed to the 
message. Unless the print flags indicate 
SYSLST only, messages will be output to 
both SYSLOG and SYSLST. 



With RETAIN/370 active, all messages to 
or from the SYSLOG device alsc print on the 
remote specialist's console. The remote 
specialist will not be allowed to answer 
certain two-way messages that give the 
operator the option of destroying data (for 
instance. Data Protection). A reply code 
of '03* is available for communication 
between the onsite CE and the remote 
specialist. This reply can he entered at 
any communications interval while RETAIN is 
active without affecting the testing 
procedure . 



IJZAD0 39S DPRINT ROOT Chart CE 

OBJECTIVE : This module handles DPRINT 
requests from an on-line test. 

ENTRY POINT : The label EPZAE039. 

EXIT : Normal-To caller. 

Error-To IJZAD052, if first error or 
catastroj^ic error. 

EXTERNAL ROUTINES: 

1. iaZADC62 -- CCW, CC, CSW, and PSW 
printing. 

2. IJZADC64 — SENSE and DATA printing. 
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3. UZi^DO70 — printing OLl messages 
(header descriptions and ccimnents) . 

4. IJZAB0 41 — converting data. 

5. IJZ1^B037 ~ printing E157I and E129I. 



INPUT : Parameter list pointed to by 
register 1. Its form is as follows: 



Word 1 - Transient Manager flags. 

Word 2 ~ Address of control ^cxd 
(see Note on list 
extension below). 

Word 3 - Message line address. 

Word 4 - TECB address. 

Word 5 - CC address. 

Word 6 - Pointer to CCW list. 

Word 7 - Pointer to expected 
CSWl. 

Word 8 - Pointer to received 

CSWl. 

Word 9 - Pointer to expected 
CSW2. 

Word 10 - Pointer to receive CSW2. 

Word 11 - Pointer to expected SNS. 

Word 12 - Pointer to received SNS. 

Word 13 - Pointer to expected 
data. 

Word 14 - Pointer to received 
data. 

Word 15 - Pointer to written data. 

Word 16 - Pointer to description 
lines. 

NOTE: The parameter list extension is 
pointed to by the ADCON in the parameter 
list. Its break-down is as follows: 



Word 1 



Control Word. 



BITS BYTE 



CCW/ICW error required 1 
(Asterisk * en message) 

CSWl error (Asterisk * 2 

en message) 

CSW2 error (Asterisk * 3 

en message) 

Spare 4 

Spare 5 

Sense error (Asterisk ♦ 6 

en message) 

Kessage print required 7 

Description print 

re qui red 

CCW pidnt required 1 

Expected CSWl print 2 

required 

Received CSWl print 3 

required 

Expected CSW2 print 4 

required 

Received CSW2 print 5 

required 

Expected SNS print 6 

reqxiired 

Received SNS print 7 

required 

Expected data print 

required 

Received data print 1 

required 
Bit 26 - Written data print 2 

required 
Bit 27 - CCW if 1; ICW if en 3 

CCW messages 
Bit 28 - Received data errcr 4 

(Asterisk * en message) 
Bit 29 - Condition code print 5 

required 
Bit 30 - Errcr condition 6 

Bit 31 - PSW if 1; CSW if en 7 

CSW messages 
Byte 5 - Message line ccunt 
Byte 6 - Offset to message byte 

count 
Byte 7 - Expected condition code 
Bytes 8 and 9 - Reference nuirber 
Bytes 10 aiKl 11 - Device address 
Byte 12 - Number of CCWs 
Byte 13 - Number of failing CCWs 
Byte 14 - Expected CSW field 
Byte 15 - Expected SNS byte count 
Byte 16 - Received SNS byte count 
Byte 17 - Description line count 
Bytes 18 and 19 - Expected data count 
Bytes 20 and 21 - Received data count 
Bytes 22 and 23 - Written data count 
Byte 24 - Description byte ccunt 



Bit 


9 


Bit 


10 


Bit 


11 


Bit 


12 


Bit 


13 


Bit 


14 


Bit 


15 


Bit 


16 


Bit 


17 


Bit 


18 


Bit 


19 


Bit 


20 


Bit 


21 


Bit 


22 


Bit 


23 


Bit 


24 


Bit 


25 



2 

2 

2 

2 
2 
2 

2 
3 

3 
3 

3 

3 

3 

3 

3 

4 

4 

4 

4 

4 

4 

4 
4 



Bit 0, 1,, and 2 ~ Forms control 0-2 1 

Bit 3 - Header required 3 1 

Bit 4 - Spare 4 1 

Bit 5 - Spare 5 1 

Bit 6 - Error print required 6 1 

(Asterisk ♦ on message) 

Bit 7 - REFNDM (Reference 7 1 

number) required 

Bit 8 - Overlap on I/O 2 



NOTE: Fields that are net used are not 
checked. 



OUTPUT: On-line test section header, 
description, comment messages, E157I, and 
E129I catastrophic error message. 
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MET HOE ; The DPRINT function is siabdivided 
as follOTitfs : 



ENTRY POINT: Label EPZAEC40. 



• Determine if printing should be 
suppressed. 

If NPR and either EL or TL options are 
active^ all DPRINTS are suppressed. 

If NEP option is active, all error 
DPRINTS except first error and 
catastrophic error DPRINTS are 
suppressed. 



If NEE option is active, first error 
message (E129I) is suppressed. 



Process the OLT request to print, 
request can be broken down into 7 
unique catagories. They are; 



1. Beader: a one line test 
description iressage formatted by 
UZi^D039. 

2. Description-Multi-line EBCDIC 
message formatted by IJZAD039. 

3. CCW/CC-string of channel command 
vwords or condition codes (expected, 
received) formatted by IJZADC62. 

4. CSW/PSW -status words 
(expected, received) formatted by 
UZi^D062. 

5. Sense- (expected, received) formatted 
by UZAD064. 

6. Data- (expected, received, written) 
formatted by IJZAD0 64. 

7. Comments -Multi- line EBCDIC OIT 
message formatted by IuZADC39. 



Note : All output is printed via calls 
to UZADO70. 



EXIT: 

1. scheduler (IJZADOOO) if called by OLT. 

2. To caller if called by an OLTEP 
module. 



EXTERNAL ROUTINES ; 

CECOM (IJZAD037) . 

INPUT; Parameter list pointed to by Rl. 

OUTPUT; Messages; 04E199D, 04E221E, 
E222I, E229I, E233I. 



Each METHOD: Upon entry into this module. 



standard linkage converticns are followed 
and the Iccal-print-only bit is set. If it 
is an OLT request message (E229I) is issued 
to inform the operator that the section was 
canceled, and an exit is made to the 
scheduler. If running en a ncn-MPS system, 
the quiesce mode bit is turned on and a 
return to the caller is executed. 

On MPS systems, this module determines 
if teleprocessing (TP) is active. If it 
is, the foreground cannot be quiesced. A 
return to caller is executed with the 
QUIESCE bit OFF. 

When TF is not active, the operator is 
asked (via message E221E) if the foreground 
can be quiesced. If it can, message F222I 
is issued requesting the operator to issue 
the commands necessary to stop the 
foregrounds. The program information 
blocks are then checked until it is 
ascertained that all fcerground partitions 
are quiesced. Then, message 12331 is 
issued and the caller is returned to with 
Quiesce bit ON. If the answer is NO, a 
return to caller is executed with the 
QUIESCE bit OFF. 



• Issue first error and/or catastrophic 
error message (if required) and exit to 
the communication interval module 
(UZAD052). If neither is required, 
return to OLT. 



UZADom? Convert Chart EU 



UZADO40; $Mode Chart BT 



OBJECTIVE; Convert all hex digits to their 
equivalent EBCDIC characters or the EBCDIC 
characters to their equivalent hex digits 
0-F. 



OBJECTIVE ; Determines if it is possible to 
place the foreground partitions in a 
quiescent state; and if it is, waits imtil 
the foregrounds are quiesced. 



ENTRY POINT; Label EPZADOUl. 
EXIT; Return to caller. 
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INPUT : Rl points to parameter list which 
contains : 

• Address: Of characters tc be 
converted. 

• Address: Of the converted characters. 

• Count: Number of bytes tc convert. 

• Type: Bex or EBCDIC (H/E). 



OUTPUT : Return codes: 

X'OO' = Successful ccrnpletion. 

X*04* = Macro level not ccmplete. 

X'08' = Invalid hex to EBCDIC 

conversion. (The address of 
the failing character is in 
GPRl.) 

METHOD: TC determine which ccnversion is 
to be made, the module tests bit of the 
fotarth word of the parameter list passed by 
register 1. If the bit is en, conversion 
is from hex to EBCDIC (H/E)? cther^^ise, 
from EBCDIC to hex (E/H). 

In the Bex to EBCDIC conversion, four 
bits are converted at a time* Every hex 
character has an EBCDIC ccnversion. (2 
bytes of EBCDIC per 1 hex) 

If the ccnversion is from E/H, the 
program checks to determine if the byte 
count is odd. If so, a switch is turned 
on. Each EBCDIC character is converted 
into a hex character of four bits. Thus, 
it takes two EBCDIC characters to form, a 
byte of hex characters. 

Therefore^ if the switch is on 
(indicates an odd number of EBCDIC 
characters) after the last ccnversion, this 
module also converts a FO into a hex to 
complete the last byte. 

After each conversion is ccmpleted, 
successful cr not, the registers are 
restored, and an appropriate return code is 
sent back to the caller. 



IJZAD042; MQRECORE Chart BV 



OBJECTIVE : Provide available core space to 



EmBY_VOimz The label EPZAE042. 

EXITS: Return to the cr-line test. 

INPUT: KAXSIZE, maximum number of the 
bytes required. MINSIZE (cpticnal), 
minimum number bytes required. 



CUTPUT : 



Return cedes: 



the calling routine. 



X*00' = Successful cere allocation. 
X'04' = MCRECORE facility not 

available. 
X'08' = Cere requested net available. 
PO = Size of allecated cere. 
PI = Address cf allecated core. 

jyETHCD; The first time mcreecre is 
requested, the Mcre/Eree cere chain is 
initialized by creating a "free" area from 
the end of the Cn-Line Test Section tc the 
end of the partition ($ENDPART). The 
starting address cf this area is put in the 
CLTEP common area at label $ESTFREE. If 
there is no cere available, a return cede 
of X*08' is given. 

The F.ore/Free cere chain is searched for 
the smallest free area that will meet the 
maximum requirement, or if none is found, 
the smallest area that will meet the 
minimum requirement, cr if ETWN=YES was 
specified (macro level 3) , the largest area, 
between maximum and minimum request. 

If these requirements cannot be met, a 
return cede cf X*08* is given. If the 
amount of cere allocated to the OLT is less 
than the area from which it was given, a 
new free area is entered in the chain. 

A doxible word at the beginning cf each 
Kore/Free area is reserved for management « 
The first word indicates the size cf the 
area. This is always a multiple cf eight 
bytes and the lew order three bits may be 
used for flags. Bit 7 indicates a free area^ 
if on, or a morecore allocated area if off« 
Bit 6 indicates that a morecore area was 
us^d for a plink module. The second word is 
a pointer tc the next Kere/Eree cere area. 
This pointer is zero for the last entry in 
the chain. The address returned tc caller 
is the address following the double word? 
and the size .passed is the size minus the 
doi±>le word, if filling a ET^N request. 
Otherwise, it is the requested maximum cr 
minimum size. 

The section control table is accessed tc 
get the CLT partition size. The Sectien 
Preface is referenced for the OLT Sectien 
size (Root and PLINK modules). 
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IJZJ^EQ43g FREECORE Chart CA 



IKFUTs 



OBJECTIVES s Free up an area of core 
previously obtained by a MORECORE request. 

ENTRY POINT : Label EPZADO^B from the CIT 
via transient manager. 

EXIT : Return to the on-line test via the 
transient manager. 

INPUT: The address of the area to be 
freed. 



OUTPUT: Three possible return codes are 
passed to the caller in register 15: 

1. X'OO* = Indicates that the area has 
been successfully freed. 

2. X'04' = Indicates that the FREECCRE 
facility is not available. Given v^hen 
macro level is incorrect. 

3. X'08* = Indicates that the address 
specified does not correspond to an> 
returned on a MORECORE request 

MET HOE ; The More/Free cere chain is 
searched for an entry matching the 
requested area to be freed. Vihen that area 
is found, it is combined with any 
contiguous free areas tc form a ney^ free 
area. The FREE flag in the size field is 
set and a return code of X'OO' is given. 

Note: see IJZAD042 - MORECORE for a 
description of the Mere/Free core 
chain- 



UZACO^^: £10 Chart CB 

OBJECTIVES : Issues the required privileged 
instruction (HIO, TIO, or TCH) to the 
primary or secondary device for a calling 
routine by utilizing a SVC 46 and loading 
$$BOLTEP to allow the I/O f cr other 
partitions to complete. 

ENTRY POINT ; Label EPZAD044, A44TRY. 

EXIT : Return to caller. 

EXTERNM. ROUTINES : 

1. $$BOLTEP CIJZAOLTP). 

2. SVC46. 



EFZADC44 — Rl pcir.ts tc a parameter 
list which contains: CES address, 

operation requested, TECE address » 

A44TRY -- 

• GPRO — parameter list address. 

• GPRl — Address cf A44TRY. 

• GPR7 — Return address cf supervisor - 



CU T PUT: Return cedes: 

X'OO' = CC status, sense posted. 
X'04' = 

• Frcm Entry EPZAEC44 — Pvrong 
macrc level, device not in 
device entry table, cr request 
cannot be hcrcred because the 
channel is busy and the CCE has 
an appendage. 

• Frcir entry A44TRY — Byte cr 
parameter list is set tc: 

— Successful 
4 — Unsuccessful 
Unchanged — Retry. 



NETHCE: Fcr the EIO request tc be 
performed, the specified device must be 
grabbed cr priirary. 



If TCH is requested, SVC46 is issued to 
enter superviscr state. The privileged 
operation is then executed and the 
resulting ccnditicn cede pcsted. 

If a TIC cr HIO is requested, $$BOLTEP 
(IJZACITP) is loaded tc allcw the I/O fcr 
all other partitions tc complete on the 
sam.e channel as the unit being tested. If 
the channel is busy and the CCE has an 
appendage , a return code cf 4 is issued and 
the request is not performed. When all I/O 
activity or tiie chcinnei has couplet fed, the 
TIC/HI C is performed by mcdule IJZAOLTP 
issuing a SVC46 and entering this mcdule at 
A44TRY. 

If a ccnditicn code (CCl) occurs on a 
TIC or HIC, the CSW is pcsted. If unit 
check occurs in the status, a sense is 
issued and the sense data is pcsted in the 
sense field of the TECE. If no sense field 
is available, the sense is issued with the 
suppress data transfer bit en. 

After ccnditicn code posting and status 
examination (when necessary) , control is 
returned tc the OLT with a return code cf 
X'OO*. 



Note: See IJZACLTP ($$EOLTEP) for 
interface with this mcdule. 
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IJZJ^£Q45: Trace/Return Code Handling 
Module - Chart CC 



OBJECTIVES : This module will provide a 
trace of all calls fcr OLTEP function made 
by the OLT when the cpticn TR is active. 
If a return code produced by an OLTEP 
function is irasked OFF by the OLT, this 
module will be entered tc print the E450I 
message and cause teririnaticn cf the CIT. 

ENTRY POINT : The label EPZAD045 

EXIT: Normal: 

To caller ~ Always transient manager 
(no return code) . 

Error : 

TO $DTRMLNK tc terminate OLT (with 

action value = 1). 



EXTERNAL ROUTINES : 
!• UZAEOai - convert data. 
2. UZAD037 - print message. 



CLT viishes tc handle. If a return cede is 
given that has been masked cff, cr if the 
TP option was selected, this mcdule will 
receive contrcl frcm the Trarsient Manager. 
The data pointed to by register 1 
(parameter list defined above as input) 
will be decoded and put intc message E450I. 
The return cede is checked, and an asterisk 
put in the message if this cede has been 
masked OFF. (If the OLT is already in 
CLEANUP, the return cede is net checked) . 
A masked CFF return cede will cause the 
E450I message to be prirted and the OLT to 
be terminated. If the cede is acceptable, 
or the OLT is in CLEANUP, and the TR cpticn 
is in effect, the E450I nessage will he 
printed. Beturn is tc the caller which is 
always the Trasient Manager. 



If the TR cpticn is CN, this module will 
receive ccntrel after every CLTEP funeticn 
requested by the OLT, but will only 
termdnate the CLT if the accompanying 
return code handling forces it. 



INPUT: Rl points to the parameter list. 
The param^eter list is as follows: 



iaZADCil7: Routine Chart CD 



Eyte Transient manager flags 

Eyte 1 Filler 

Eytes 2-3 Characters 45 (ID cf this 
module) 



OBJECTIVE: Determine whether a given 
routine should be run by checking the 
appropriate bits in the secticn ccntrel 
table. 



Eytes 4-7 



R14 of OLT. 
to OLT) 



(return address 



Eytes 8-11 R15 for OLT. (return code in 
low order byte) 



ENTRY POINT: Label EPZAD047. 

EXIT: To the calling routine. Tc the 
Routine following the calling routine, if 
the calling rcutine carrct be run. 



Eytes 12-15 RO for OLT. (either data or 
previous value) 



EXTERNAL RCUTINE: CECCM (IJZAE037). 



Eytes 16-19 Rl for OLT. (either data or 
previous value) 

Eytes 20-23 R2 of OLT (previous value of 
OLT register) 



Rl points to a parameter list which 



INPUT: 
contains: 



• Address of next routine. 



Bytes 24-25 Character ID of called 
function 



OUTPUT : Message E45 0I [*]RTN XXX, ID XX, AT 
XXXXXX, RC XX 



• Address of ETNTERM (if TERM=YES) 

• Reference number used in header of 
error printed. 

OUTPUT: Message: E210I. 



Note : This message is output to 
the SYSLST device cnly. 

METHOD : When return code handling is in 
effect, a mask byte in the SCT is set by 
the OLT to indicate the return codes the 



METH OD : After the program verifies the 
correct macro level, a check is made fcr 
the MASK=MI parameter. This indicates a 
need for manual intervention. If this 
parameter is included, ROUTINE interrogates 
the MI bit in the section control table to 
determine if the CE selected this option. 
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If MiVSK=MI is specified and the CE has not 
selected this option, the following message 
is printed: 

E210I ROUTINE XXX BYPASSED - MANUAL ICTV 
REQUIRED 

and a branch is taken to the next routine. 
If the MI bit is on or if MA£K=MI is not 
indicated, the routine irask in the section 
control table is checked to determine if 
the bit corresponding to the calling 
routine is on. If nct^ the routine cannot 
be run and a branch is taken to the next 
routine. If the routine bit is on, the 
active routine number in the section 
preface is updated, the error bit in the 
section control table is reset, the 
reference number (if any) is moved into the 
section preface, and the routine is allovved 
to run. 

The TERM=Y1S parameter designates the 
last routine of the irodule. In cases \«ihere 
this routine is not allowed tc run, RCUTIISIE 
branches to RTNTERM, the address of 
termination code in the last routine. 



scheduler (IJZAEOOO) tc teririnate the 
active OIT. The scheduler will then give 
control tc the EQUATE ircdule. 

The Equate Table ($EQUTAE) will be 
cleared to X'FF' when 'CLR' is the response 
to message 04E394E. Ertries are made in 
the table when device equates are entered. 
There are three different acceptable 
fields: 

Multiple equates (for example, 180, 182, 
184 = 290) 

The result will be that each actual unit 
address on the left of the equal sign will 
be put into the Equate Table along with the 
unit address en the right cf the equal 
sign. The unit address en the right side 
indicates the CES that will be used. 

Inclusive equates (for example, 180 - 183 = 
290) 

The inclusive units en the left cf the 
equal sign will be put into the Equate 
Table along with the unit address on the 
right cf the equal sign. The unit address 
on the right side indicates the CES that 
will be used. 



UZADQ49: EQUATE Chart CE 



OBJECTIVE : To set up a table cf actual 
unit addresses that will use the CDSs of 
similar devices having different unit 
addresses. 

ENTRY POINT : EPZAD0 49 - from scheduler 
IJZAEOOO if OLT was active. 

- from communication 

interval (IJZAD052) if CIT 
was not active. 



EXIT; 



Communication Interval (IJZAD052) 



EXTERNAL ROUTINES : CEC0^5 (IJZAD037) 

CONVERT (IJZAD041) 

INPUT : Reply from message 

04E39 4D ENTER DEV EQUATES /END /CIR 

OUTPUT : Messages 04E199D, 04E394D, E395I, 
E396D, E397I, E398I 
$ FLAG 2 

$EQTACT - set on when table has an 
entry 
- set off when table is 
empty 
$EQUTAB - contains device 

addresses that have been 
equated. 

METHOD : 'EQU* response to m.essage 01E105D 
allows entry into the EQUATE module 
directly if an OLT is not active. If an 
OLT is active, the communication interval 
(IJZAD052) will give control to the 



Simiple equates (for exairple, 180 = 290) 
The result will be that the actual unit 
address en the left cf the ecual sign will 
be put into the Equate Table along with the 
unit address en the right cf the equal 
sign. The right unit address indicates the 
CDS that will be used. 

If the field has both a ccmma and a 
dash, that field will be sent tc the 
operator indicating an errcr. When END is 
the response tc miessage 04E394E, the 
contents cf the table will be sent to the 
operator. If the table contents are 
correct, a response of YES tc message 
04E396D will allow the exit tc the 
communication interval (IJZAEC52) to resume 
CLTEF Gperaticn. If Lhe table coiiteiitjD art: 
not correct, a response cf NO to message 
04E396D will allow a return tc message 
04E394D to correct the table entries. 

The only exit from this mcdule is a 
response of YES to message 04E396E. If 
there are entries in the table, the $EQTACT 
bit will be en to allow GETCCNFIG 
(IJZADC16) to use the table. This bit is 
reset when 'CXR' is requested and set on 
when 'END* is requested, provided there is 
at least one entry in the Equate Table. 



IJZAD062J 



CCW/CSW MESSAGES Chart CG 



CBJECTIVE; Fcrmat the CAW, CCW, CSW, CC 
and PSW for the OLT into a message and call 
the output mcdule to print the data. 
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ENTRY POINT : EPZAD062. 

EXIT : Normal -to caller. 
Error -none. 

EXTERNM. ROUIINES ; 

1. IJZAB041 - for converting data. 

2. IJZi^DO70 - for printing the messages. 
INPUT: 

1. General register 8 points to the 
EPRINT parameter. 

2. General register 5 points to the 
parameter list extension. 

OUTPUT: Formatted message lines to be 
printed b^ UZADO70. 

METHOE: This module will format CAVv^ CCW , 
CO, CSW, and PEW. If information is not 
supplied in the parameter list, the TECB 
specified will be searched. 

This module actually has two sections. 
They operate as follows: 

1. The first section formats the CCVi and 
CC. 

CCW is printed if requested and the 
address of the CC^ is provided. If 
the CCW is requested and the address 
is not provided, the return code is 
set to X'OC". 

Expected CC is printed if requested 
and the address of the expected CC is 
provided. If printing of the expected 
CC is requested and the address is not 
provided, the return code is set to 
X'OC . 

Received CC is printed if requested 
and either the address cf the received 
CC is provided or the address of the 
TECB is provided. In the latter case, 
if a device address is provided, a CC 
for that device is printed. If the 
TECB has no entry for the requested 
device the return code is set to 
X'OC. If the device address is not 
provided the TECB is searched for the 
first device for which the CC has teen 
posted, and that CC is printed. 

2. The second section formats the CSW. 

When printing of the CS^ is requested, 
the expected CS^ is composed only of 
those parts supplied in the DPRINT 
request. The received CSW contains 
all four items: key, address, status, 
and residual count. If the CSW 
address is not given, the TECB is 



searched, using the device address for 
the needed information. If the device 
address is net giver, the primary 
device address is used. If the OLl 
makes the request, the output line may 
have an asterisk or. it. 

Note: If the TECB is searched and found to 
be empty, there is a check to see if a 
Timeout in Queue occurred. If a timeout 
occurred and RCVE CC is requested, the 
following is printed: 

RCVE CC CUEUEE 

If the TECB is empty but nc time out 
occurred , 

RCVE CC 

is printed. In either case, if the TECB is 
empty and RCVE CSW is requested, the 
folloT^'ing is printed: 

RCVE CSWl NCNE 

or 
RCVE CSW2 NCNE 



IJZADC64: 



SENSE/EOTA Chart CK 



CBJECTIVE: This module ccnstructs sense 
data messages to be printed by module 
IJZADC70. 

ENTRY POINT: EPZAE064. 

EXIT: To caller. 

EXTERNAL RCUTINES : 

• IJZADC41 - TO convert data. 

• laZADCTO - To print the messages. 
INPUT: 

1. General register 8 points to the 
DPRINT parameter list. 

2. General register 5 points to the 
parameter list extension. 

OUTPUT : Formatted message lines to be 
printed by IJZAEO70. 

KETHOD; In the first part cf this module, 
the expected and received sense messages 
are formatted. If the received sense field 
is specified in the parameter list, the 
data is formatted and printed without 
accessing the TECB. If the received sense 
field is net specified, the TECB is 
searched using the device address. If the 
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device address is not specified, the 
primary device address will be used. Upon 
request, the sense message can be preceeded 
by an asterisk. 

The second part of this ircdule 
constructs expected, received, and viritten 
data messages. The data is either EBCDIC 
or HEX and may be multiple lines if it is 
greater than the line limit. An asterisk 
will be added to the messages if a flag is 
ON in the parameter list. 



Note: 



If the 1ECB is searched and found to 



be empty, the following message is printed 
if sense print is requested: 

RCVB SNS NONE 



IJZACO70: output V^'riter Chart CK 

OBJECTIVE : Provide the routing codes for 
EPRINT and some OLTEP messages and calls 
CECOM (UZAD037) to print. 

ENTRY POINT : Label EPZADO70. 

EXIT: Return to caller. 

EXTERNMi ROUTINES : CECOM (IJZAD037) . 

INPUT : A pointer to a parameter list is 
supplied, in GPRl, by the caller. The 
parameter list contains a: 

1. Eour-byte pointer tc the message. 

2. One-byte forms control character. 

3. One-byte message length (in bytes). 

OUTPUT: The message is printed on SYSTST 
and, if required, on SYSLOG devices. 

MCTHOE: This module routes error messages 
(EPRINT) as follows: 



IJZADC71: Prcmpt Chart CN 

OBJECTIVE: Cutput cpticE messages, E1^7I, 
E148I, and Eli*9I. 

ENTRY POINT: EPZAE071. 



EXIT: 



Ncriral tc IJZAE052. 



EXTERI^AL ROUTINE : 
module r 



CECCK (IJZAE037) print 



INPUT: R3 contains bit irask for messages 
(lovi order byte only) 

Eit net used 

Eit 1 not used 

Eit 2 not used 

Eit 3 not used 

Eit 4 not used 

Eit 5 Print message E149I 

(Cpticns message) 

Eit 6 Print message E148I (test 

message) 

Eit 7 Print iressage E147I 

(device message) 

Note: Kjessages are printed in reverse 
order, that is, bit 7 message, bit 6 
message, etc. 

CUTPUT: Any ccmbinaticn of messages: 

E147I - PRCKPT EEVICE MESSAGE 

E148I - PROKPT lEST MESSAGE 

E149I - PROMPT OPTION MESSAGE 

METHOD: The messages printed are 
multi-line and cf variable length. A mask 
is passed tc this module in general 
register 3 . Each bit represents cne cf the 
messages tc be printed. If less than 8 
messages are present, the lew order hits 



^ill be used first 
ignored. 



*nc3 ur.U3€u 



bits will Le 



The error messages are issued to 
SYSLST. These are also issued to 
SYSLOG if all the fcllowing are true: 

1. A console keyboard is assigned to 
SYSLOG. 

2. The parallel printer option is 
selected. 

3. The message level agrees with the 
parallel printer level option 
specified by the operator. 

CECOM (IJZAD037) is called to perform 
the required I/O tc issue the message. 



IJZADC76: REI Initialize #1 Chart CR 



CBJECTIVE; Determines if RETAIN/ 370 can 
operate on the system. 

ENTRY POINT: EPZAE076. 

EXITS: 

1. Communications Interval (IJZAE05 2) if 
unsuccessful. 

2. REI Initialize #2 (IJZAE077) if 
successful. 
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EXTERNAL ROUTINES : 

1. CECQM (IJZADOBT) to issue messages. 

2. Scheduler CIJZADOOO) to cleanup for 
OLT rerccval via $DTRMI.NK (with action 
value=l) . 



INPUT; 



None. 



OUTPUT ; Messages E163I and E164I. 

METHOE: The module deterirines if REI is 
alread;^ in irain storage. If it is, a 
message is issued and the Ccirmunications 
Interval module is entered. If the module 
isn't already in, the following checks are 
made to determine if it can fce loaded: 

• Does the supervisor support REI? 

• Is the REI device (IBM 2955) assigned 
to SYS005? 

• Is a console device available? 

• Are console interrupts (FOPT 0C= YES} 
allowed? 

• Is the background partition at least 
18K? 

If the answer to any of these is no, 
message E164I is issued and exit is taken 
to the Communications Interval module. If 
all the conditions are met, the current 
OLT's cleanup routine is performed and the 
REI Initialize #2 module is entered. 



IJZAD077; REI Initialize #2 Chart CS 

OBJECTIVE ; Establish communication with 
the remote analysis center. 

ENTRY POINT : EPZAD0 77. 

EXIT: Commiunications Interval (IJZADC52) 

EXTERNAL ROUTINES : 

1. CECOM (IJZAD037) to issue messages. 

2. REI nucleus (IJZADOIO). 

3. REI Terminate (IJZAD078). 
INPUT : None. 

OUTPUT ; Messages E163I and E164I. 



METHOD ; The core storage available to the 
CLT is reduced by 4K tc be occupied by the 
REI nucleus. The REI nucleus is then 
loaded in the top 4K of the partition and 
ADCCNs are resolved by calling the 
relocation routine in the nucleus 
(IJZADCIO). The REI device (lEM 2955) is 
opened, and ccmmunicaticr.s with the remote 
analysis center is attenpted. If 
communicaticns are established, and the 
proper response is received, the line is 
put in receive mcde, message E163I is 
issued, and the Ccmmunicaticrs Interval 
module is entered. If ccnmunicaticns 
cannot be established, or the proper 
response is net received, the tor rowed 4K 
is returned, IJZAD078 is invoked, and on 
return from IJZAD078 the Ccirnunications 
Interval module is entered. 



IJZADC78: REI Terminat e Chart CI 

CBJECTIVE; Deactivate RETAIN/ 370. 

ENTRY POINT: EPZAE078 . 

EXIT : Return tc caller. 

EXT ERNAL ROUTINE: CECOM (IJZAr037) to 
issue message. 

OUTPUT; ly.essages E137I, E167I, and E169I. 



METHOD: 



This module is entered if either 



the on-site CE or the reircte specialist 
enters STCPREI at a ccEmunications 
internal, or if PEI activaticn cannot be 
completed. The fcllowir.g actions are 
taken: 

1. All active CCEs are canceled. 

2. The REI device is closed. 

3. Message E169I (RETAIN/370 TERMINATED) 
is issued. 

U. All REI switches are reset. 

5. The borrowed 4K is returned. 



IJZADCAA: $EEate Chart DA 



OBJECTIVE: Provide the calendar date tc 
the requestor. 

ENTRY POINT; Label EPZAEOAA. 
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BXITs 



Return to caller. 



ENTRY FCIFT: Th^ label EPZi^EOi^J. 



INPUT: Eate field of Coiriruni cations 
Region. 

OUTPUT : 

1. miP/d in EBCDIC - (GPRO), 

2. di/yy in EBCDIC - (GPRl). 

3. Return codes: 

X'OO* = Date returned in GPRs. 
X"04" = Facility not available. 

METHOD: This module provides the calendar 
date in registers and 1, in the forir.at 
MM/DD/YY. The date is retrieved from the 
communicaticn region, reforrratted (if 
necessary) and returned to the caller. 



EXIT: 



Return tc caller. 



EXTERNAL R OUTINES : 

1. iaZi^D016 - GETCONEG 

2. IJZAD037 - CECOM 

3. IJMD04Q - $l^.ODE 



INPUT: Rl points to a pcinter to starting 
address and device exter.t for the cciitrcl 
unit tc be tested. 



UZADOJ^B; $DTIME Chart DB 

OBJECTIVE : Provide the tiire cf day to the 
requestor. 

ENTRY POINT : Label EPZADOAB. 

EXIT : Return to caller. 

EXTERNAL ROUTINES : GETIME (SVC34). 

INPUT : Not applicable. 

OUTPU T : Return codes in GPR15: 

X'OO' = Operation successfully 

coinpleted. 
X'04» = Facility not available. 
Tirre of day in packed decimal 
(GPRl). 

METHOD ; This module provides the time of 
day. The tiire is retrieved, using the 

^ * , <•, Ji» ^ WW r^urr, Tt.iHr: *w.-,,«.-«.^ •_*«! j-'U Jul*. ^ nrr-n tsiry^ -n-rs 

parameter, and returned to the caller in 
GPRl in packed dec lira 1 f crmate 

Time is given in hours, irinutes, and 
seconds military time in GPRl packed 
decimal. The format is OHHMMSSF. For 
example 3:45 PM would be represented by 
0154500F in GPRl. 



OUT PUT 
1 



l^^essages 04E243D, E244I, E127I, 
04E199D, E399I. 

Return cedes: 

A return cede of X'OC* will be given 
if any cf the fcllcwirg are true: 

There is no primary ^r grabbed 
device in the range. 
An invalid cede was specified 
(net supported by EOS) . 

A return cede cf X'08" will be given 
if any of the fcllcwirg are true: 

Device (s) within the range not 
assigned tc the Background. 

Device (s) centrel unit may be 
accessed by another CPU. 

Devicfe (s) within the range is a 
system unit. Fcregxcunu guiesce 
required but net available. 

A return cede of X'04' is given if the 
macro level is invalid er if there are 
equates active- 

A return cede of is given if all the 
requirements are net. 



UZADOAJ: ^CUTEST Chart DJ 



OBJECTIVES : Check ownership cf devices 
when a test section needs exclusive use of 
a control unit for centrel unit testing. 
Call $MOEE (IJZADO40) te qui e see 
foregrounds it required. 



I Method ; The PUB table is searched to deter- 
mine if all the devices in the extent are 
assigned to the background and to verify 
that there are no system required devices in 
the extent, that is, SYSLST, SYSLOG, SYSVIS, 
SYSRES, SYSREC, SYSCLB. The CDSs are 
examined to determine if there are CPU 
shared devices in the extent. 
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If there are systeir devices, or devices 
not belonging to the background in the 
extent, iriessage BG E244I will be issued. 
If there are CPU shared devices in the 
extent, iressages BG E2^^1 and BG 04E243D 
will be issued. A 'no' reply to the 
EG 04E243D iressage will result in a return 
code '00'. A 'yes' reply will result in a 
return code of X"08'. If DA£D devices are 
in the extent, an atteirpt will be inade to 
Quiesce the foregrounds. If quiesce is not 
available, a return code of X'08' is given. 



I JZATCIT ($$ETCLTP) : Teririnate 

CLTEF^ Cha rt C£ 

OBJECTIVE: Eerforir clearup functions for 
CLTEP if an abncriral teririraticn occurs. 

EKTRY PCIlvT; EPETCLTP. 

EXIT: To the supervisor ($$EE0J3). 

EXTERl^AL RCUTINES : 

1. REI Teririnate (IJZi^EC78) to deactivate 
the RETAI15/370 Interface. 



IJZAOLTP: $$BQLT£P Chart DP 



OBJECTIVE : Indicate to the system that 
OLTEP is active. Allow I/O activity to 
complete in other partitions so that 
UZAD044 can issue a TIO or HIC. 



2. Restore Labels (IJZAD057) to r ester e 
tape labels and disable TP lines. 

3. The CIT cleanup routine if available. 

4. The Scheduler CIJZACOOO) for EXIO 
c lea nup . 

IKPUT: LUES and PUBS. 



OUTPUT: 



l^cne. 



ENTRY PQ INT : IJZAOLTP + 8 . 



EXITS ; Return to caller. 



INPUT : • One entry frcir IJZAD044, a 
pointer to A44TRY routine in IJZAD044 is 
passed. 

• One return froir A44TRY routine, a 
return code is set. 



OUTPUT: OLTEP active bit is set. 



METHOE: This module is a $$B transient 
called hy IJZAEOLT to set a bit in the 
supervisor indicating that OLTEP is active. 
This bit is examined by the supervisor when 
an SVC46 is issued, to ensure that it is 
OLTEP that issued the SVC 4 6. 

If a TIO/ BIO has been requested, module 
UZAD044 loads this ircdule with the entr]^ 
point A44TRY in a parameter list. IJZACLTP 
determines that it has been called by 
UZAE044 by checking the OLTEP active hit. 
If it is on, a SVC22 is issued to seize the 
system but allow I/O interrupts, A SVC 4 6 is 
then issued to execute the A44TRY routine 
to perform the TIO/HIO in module IJZADC44. 
Upon return from module IJZAD044, the 
return code is checked tc see if the 
operation was completed. If the operation 
was not completed, return to module 
UZAC044 b^ way of SVC46. If the return 
code indicates that the operation was 
completed, another SVC 2 2 is executed to 
release the system and IJZADOLP issues a 
SVCll to return to the caller. 



KETHCD: Upon entry, the abKcrnal 
termination flag is set, EXIO cleanup is 
performed via the Scheduler and the OLT 
cleanup routine is perfcrited if one is 
available. If RETAIN/370 is active, the 
REI Terminate ircdule is entered tc 
terminate the RETAIN/370 Interface. Tape 
labels are restored and TP lines disabled 
if necessary by the Restore Labels module. 
Any regaining cards for card-input are 
flushed. The CLTEP Active flag is then 
reset and exit is taker tc the COS 
supervisor. 

If this mcdule is ertered because of an 
error in cleanup, the CLTEP Active flag is 
reset, and exit is taker, tc the supervisor. 
All other cleanup procedures are bypassed. 



Pre-Release 25 Support Modules 



The OITEP/CLT support ircdules that follow 
were used by CLTEP prior tc release 25. 
They are retained as part cf OLTEP to 
support previcusly written OLTs. 



IJZACECM: 



CE Ccmmunicaticn Chart EA 



OBJECTIVE; Provide two-way communications 
between the P3116 OLT and the operator. 



EXTERNAL ROUTINE: 



IJZAE037, 
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ENTRY POINT : EP ZACEOM . 

EXIT ; Return to calling ircdixLe. 

INPUT : Rl points to parameter list. 

OUTPUT: Re-foritatted paraireter list is 
passed to UZAE037. 

METHOE: When the inacro is issued, a 
pointer indicates the iressage to be issued ^ 
the length of the message, and an area 
where the reply can be placed. 

This module reformats the parameter list 
received, into one acceptable by IJZADC37 
and issues a call to that module. On 
retixrn fromi IJZAD037, exit is to the caller 
via R14. 



Once the program determines which 
portions of infcrmaticr are relevant, it 
compares them with the expected information 
found in the checkfield. Ir each case, if 
the received data does net compare 
favorably with the expected data, an error 
switch is set. 

After these ccmpariscns are completed or 
if the TECE is not relevant, the program 
checks the data tc determine whether cr not 
it is relevant. The relevant data is then 
compared tc the expected data, and a switch 
is set if the ccmpariscn is unfavorable. 

Finally, a test is made tc determine if 
any errcr switches have teen set. If any 
have been set, the errcr exit to the unit 
test is used. Otherwise, the return is 
norma 1 . 



IJZACOMP; Compare Chart ED 



OBJECTIVE : Check received data against 
expected data. 

ENTRY POINT : I JZACOl^P . 

EXIT: Return to OLT. 

INPUT: Rl pointer tc parameter list 
containing the address of check field and 
error return code. 

OUTPUT: Eits 24-31 of R15 are error flags 
indicating the results of the compares. 

METHOD ; This module sets up a pointer to 
the checkfield that is used for the compare 
function. The checkfield contains the 
information to compare. The first test in 
the compare miodule determines whether or 
not the TECB is relevant. If it is, some 
portion of the TECB information must be 
checked- The entire TECB is checked to 
determine if the following are relevant: 

• CC. 

• CSW Address. 

• Device Status. 

• Channel Status . 

• Residual Count. 

• Sense Data. 

All this information is initially 
entered in the TECB from the last seven 
bytes of the CSW and the last eight bytes 
of the Channel Command Block (CCB) . 



IJZACCKV: 



Convert Chart EE 



CBJE CTIVE: Convert data frcm hexadecimial 
to EBCDIC and vice versa. 



ENTRY POINT: 



IJZACONV. 



EXIT: Return tc calling module. 

INPU T: Pointer to parameter list (GPRl) . 

OUTPUT: Converted data. 

NETBCE: The convert macrc wcrks in the 
following way: 

A pointer is initiated tc point to the 
following table: 

J. ^ , . ^ 

jWord/ j I 

iByte I I 

^ + ^ 

I 0/1 I Address of data tc be converted | 
^ + ^ ^ 

I 4/2 I Address of data after conversion | 
I 1 ^^^^^„ 1 

I 8/3 I Address of next wcrd | 

^ + -.^^ 

I 12/4 I Byte2 = FLAGS | 

I I I 

I I Bit = convert frcm hexadecimal | 
I I tc EBCDIC I 

I I I 

I I Bit 1 = convert frcm EBCDIC tc | 

I I hexadecimal. Contains | 

I I count cf data to be | 

I I converted. j 

L . i.-^ . . ^ -J 
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If the characters to convert are EBCDIC, 
they are coirpared to a translate table of 
he xa dec lira 1 characters tc make the 
conversion (vice versa if the conversion is 
from hexadecimal to EBCDIC). 

If no iratch is found in an EBCDIC to 
hexadeciiral conversion, an error code is 
inserted in general register 15, and the 
program returns to the entry point. Ko 
error indicator is used for hexadecimal to 
EBCDIC conversion because every hexadecimal 
character has an EBCDIC equivalent. 

If the conversion is completed, the 
characters are placed in an cutput area, 
and control returns to the calling routine. 



IJZADOLE; Old Support Chart EF 



KETHOD : The second byte of the first word 
of the parameter list irdicates the 
function - an EXIC, a WAIT cr printing ~ to 
be performed by this module. The second 
^ord of the parameter list (the contents of 
GFRl vihen the CLT made the call) points to 
a parameter list (in ore cf three formats) 
that contains the information necessary to 
carry cut the function asked for. 



If the function is EXIO this module 
checks the File Protect Kcde (EPM) tit in 
the SCT. If en, all CCWs are scanned for 
DASD ^rite commands. If any EASD write 
com.mands are found, message E313I is 
issued, a flag is set indicating tc the 
Scheduler that this test is tc be 
terminated, and an exit is made to the 
Scheduler via $i:7rRMLNK with action value 1. 
If not in F'BE cr no Ei^SE write commands are 
found, the modules performs the following: 



UZAEOLE is the consolidation of 
pre-release 25 support modules IJZAEXIC, 
UZAWAIT, IJZADPRT, IJZACMNT, IJZAHEAD and 
UZARSLT. 

OBJECTIVE : 

1. Initiates an I/O operation, or 

2. Performs a wait operation and move 
results to OLTs TECB area, or 

3. builds the print line(s) as requested 
by the caller to be issued by the 
output writer (IJZADO70). 

ENTRY POINT : EP ZADOLD 

EXITS : 

1. Return to OLT normally, i.e., request 
honored - 



1. Clears the TECB 

2. Sets up the CCB, cr the TPCCE if the 
teleprocessing switch in en 

3. Executes the CCW, cr TPCCW. 

After these steps have been completed, the 
EXCP is executed and control returns tc the 
unit test. 

If the function is a WAIT, the wait is 
performed by using the same CCE used by the 
EXIC, and issuing a SVC 7. 

Cnce this has been satisfied, the 
following are posted in the TECB: 

• CCW address 

• CSW address 

• CCW residual ccunt 

• Sense information (if the CSW contained 
a unit check) 



2. To UZAE052 if a communication 
interval is required, i.e., message 
E129I or E157I was issued. 

3. To scheduler (IJZADOOO) via $DTRKIKK 
with action value 1 tc terminate OIT 
if request is to write en a file 
protected device. 

EXTERNAL ROUTINES ; 

1. Output Writer (IJZADO70) to print. 

2 . Convert ( I J ZADO 4 1) 

3. UZAD037 for message output. 

INPUT : GPRl points to a parameter list. 

OUTPUT : Messages E313I^ E129I, and E157I. 
Printable output lines are passed to 
IJZADO70. The unit test TECB is posted 
when a wait is requested. 



The TECB must be aligned en a fullword 
boundary and must be exactly five words in 
length. 

After these operations fcr the WAIT have 
been completed, control returns to the unit 
test. 

If the function called fcr printing the 
options presently in force are checked to 
determine if printing should be supported: 

a. If NPR and either EL cr TL (or bcth) 
options active, all DPRINTs are 
suppressed. 

b. If NEP option is active all error 
DPRINTs, except first errcr or 
catastrophic errcr DPRINTs are 
suppressed. 

c. If KFE option is active first error 
message E129I is suppressed. 
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Printing can be broken dcwn into three 
categories : 

1. heading messages 

2. coirirent messages 

3. results received messages. 

These three forms can be in any order and 
as many as needed. 

After the lines are built and the 
specified data is put out, checks are made 
to determine if a first errcr or 
catastrophic error message is to be output. 
If this is an error DPRINT ard the option 
PR is active and option EL and TL are not 
active and 

a. If IE is active, the first error 
message E129I is printed (if this 
message has not previously been 
printed for an error DPRINT viithin 
this OLT) and an exit is made to the 
Communication module (IJZADG52) . 

b. If the catastrohpic errcr bit in the 
SCT has been set to 1, the 
catastrohpic error message E157I is 
issued and an exit is made to the 
Communication Interval module 
(IJZAr052), 

c. If neither message is required, 
control is returned to the OLT. 



IJZAO PUT : output Chart EM 

OBJECTIV E; Provide one-way communication 
from the program to the operator. 

ENTRY POINT t IJZAOPUT - 

EXIT: Return to caller. 

EXTERNAL RCUTINE: CECOM (IJZAD037). 

INPUT : Pointer to parameter list (GPRl) . 



OUT PUT; Pointer (GPRl) to a parameter list 
passed to IJZAEC37. 



NETHOD; When the output writer module is 
entered, a pointer is initiated to point to 
the following table: 



(Address of data 

(to be printed 

I ^ 



^ ^ ^ 

I Forms I Eyte | 
I ccrtrcl I count of | 
I character | message | 



IJZADC37 is then called tc issue the 
message. When IJZAE037 is finished, 
control returns tc the caller. 



I J ZAPATA 2 



OBJECTIVE: 



Random Data Generator Chart EN 



Generate the indicated number 



of random numbers, and store them in the 
requesting OLT. 



ENTRY POINT; 



IJZARATA. 



EXIT; Return tc calling OLT. 

INPUT : Pointer tc parameter list (GPRl). 

OUTP UT; Rand cm data in caller's buffer. 

NETBCD; This module uses the first two 
bytes in the SCT as the starting random 
number. Eight bytes are moved to a work 
area where random bits are generated and 
stored in the requesting OLT. 

As each dcubleword of random data is 
generated, the pointer is incremented by 
eight so that newly generated data does not 
overlay previous data. This process 
continues until the last eight bytes are 
reached. When less than eight bytes remain 
generation terminates and control returns 
to the OLT. 
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Flowcharts 



EXPLANATION OF FLOWCHART SYMBOLS 



FLOWCHART ABBREVIATIONS 




SUBROUTINE 



PREPARATION 




INPUT/OUTPUT 




A GROUP OF PROGRAM INSTRUCTIONS 
THAT PERFORM A PROCESSING 
FUNCTION OF THE PROGRAM. THE 
LABEL, IF ANY, IS SHOWN ABOVE 
THE BLOCK. 



IF ANY ADDITIONAL EXPLANATION 
IS REQUIRED, ITS LOCATION ON 
THE CHART IS IDENTIFIED BY AN 
ASTERISK AND BLOCK ID, 



DESCRIPTION OR TITLE OF A ROUTINE 
THAT IS DETAILED ON ANOTHER 
FLOWCHART. THE STARTING LABEL OF 
THE ROUTINE AND THE FLOWCHART ID 
APPEAR ABOVE THE STRIPE. 



AN INSTRUCTION, OR GROUP OF 
INSTRUCTIONS, THAT CHANGES 
PORTIONS OF A ROUTINE OR 
INITIALIZES A ROUTINE FOR 
GIVEN CONDITIONS. 



A GROUP OF OPERATIONS NOT 
DETAILED IN THE FLOWCHARTS 
IN THIS MANUAL, SUCH AS 
USER'S ROUTINES. 



ANY FUNCTION OF AN INPUT/OUTPUT 
DEVICE OR PROGRAM, USUALLY 
BRANCHING TO AN I/O ROUTINE TO 
PERFORM THE FUNCTION STATED IN 
THE BLOCK. 



POINTS WHERE THE PROGRAM 
BRANCHES TO ALTERNATE PROCESSING, 
BASED UPON VARIABLE CONDITIONS 
SUCH AS PROGRAM SWITCH SETTINGS 
AND TEST RESULTS. 



ADDR 
AVAIL 


ADDRESS 
AVAILABLE 


BG 


BACKGROUND 


CAT 

CC 

CDS 

CHAN 

CHAR 

COMM 

COND 


CATASTROPHIC 

CONDITION CODE 

CONFIGURATION DATA SET 

CHANNEL 

CHARACTER 

COMMUNICATION 

CONDITION 


DE 

DESC 

DEV 

DISP 

DP 


DEVICE END 
DESCRIPTOR 
DEVICE 
DISPLACEMENT 

DATA PROTECTION 


ERR 
EXT 


EQUAL 
ERROR 
EXTERNAL 


FLD 
FPM 


FIELD 

FILE PROTECT MODE 


GT 


GREATER THAN 


ID 

INFO 

INIT 

INT 


IDENTIFICATION 

INFORMATION 

INITIALIZE 

INTERRUPT 


LT 
LTH 


LESS THAN 
LENGTH 


MAX 
MCT 
MOD 
MSG 


MAXIMUM 

MODULE CONTROL TABLE 

MODULE 

MESSAGE 


OP 
OPT 


OPERATION 
OPTION 


PERM 

PRI 
PTR 


PERMANENT 

PRIMARY 

POINTER 


RCVD 

REG 
RE I 
REQ 
RTR 


RECEIVED 

REGISTER 

RETAIN/370 INTERFACE 

REQUESTED 

ROUTINE 


SCT 

SEC 
SW 


SECTION CONTROL TABLE 

SECONDARY 

SWITCH 


SYM 
SYS 


SYMBOLIC 
SYSTEM 


TECB 
TERM 
TP 
TRANS 


TEST EVENT CONTROL BLOCK 
TERMINATE 
TELEPROCESSING 
TRANSIENT 


VOL 


VOLUME 


WRT 


WRITE 


XPTD 


EXPECTED 



DN-PAut M)NNh( fnR. AN ENTRY 
FRUM, UR AN b<il r', ANOTFiER 
FUNCTION ON THE SAMF FLUWLHAKT. 
n-iL NUMBER IN THF ■, ^NNECTOR 
lUENTlI-TLS IHF ■ < 'RK h ^ i^oNblNG 
ENTRY UR EXIT uN I HE CHAR P. 



J 



THE BEGINNING, END, OR POINT OF 
INTERRUPTION IN A PROGRAM 



OFF -FACE CONNECTOR. AN ENTRY FROM, 

i ^ AN h> I r T'., A r,lVEN POINT ON 
ANcTHtH ^I■W(M/^^j. IHl HARACTFRS 
IN '"in .NNI ( IO[ 1 itFKTTp V THF 
CHAi^I AND BLOCK FOR MULT I PI 1- FNTRIEJ 
AM. EXITS, AN ASTERISK APPEARS IN 
THE ONNECT'^P AND THE CHARACTERS 
ARE LISTED NEARBY. 
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Chart 00, 



General 



Load CLTEP 
Program 



NUCLEU S (UZADQ LT, AA ) 

Loads transienf manager 01, (AB). OLTEP nucleus, common 
area, defermines l/0» Issue OLTS RUNNING message. 



Communication Interval (IJ7AD052, AE) 

Set up for communication with operator. Issue message 
BG E105D ENTER DEV/TEST/OPT (or read card input). 
If the reply is a verb, the possible actions taken are: 

PROMPT - Calls IJZAD071 

DUMP - PDUMP macro is used 

RE! - Initiates RETAIN system via I JZAD076 

STOPREI - Terminates RETAIN via I JZAD078 

CANCEL — Issues EOJ macro to cancel BG 

TALK — Sets up for operator-to-OLT communication 

EQU - Calls IJZAD049 



Device Decode (IJZAD031, AH) 
Determine device to be tested. 



Test Decode (IJZADQ32, AK) 
Determines tests to be run. 



Option Decode (IJZAD033, AN) 



Determines options to be used. 



Scheduler (iJZA DOGO, AP) 

Loads the on-line tests. Sets up pointer 
to tables accessed by the OLT. Gives 
control to the OLT for execution. After 
all selected OLTs have been run on all 
selected devices, exit to IJZAD052. 



T 



OLT 



EXTERNAL ROUTINES USED; 

By the Initializer: 

Output Writer (70), and 
GETCONF (16). 
COMREG, STXIT. 



By the Com munication Interval; 

The PROMPT phase (71) assists the 
operator in replying to the 
DEV/TEST/OPT message, and 
CECOM (37), and DECODE Routines 
(31, 32, 33). 



By Device Decode: 

Get CONFG (16), Tape Label Restore 
(37) convert (41), and CECOM (37). 



By Test Decode and Option Decode 
CECOM (37). 

By the Scheduler: 

Data Protect (56), Convert (41), 
CECOM (37). 
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Chart 01, Kain Flow 



f IJZADOLT j 







' 






IJZADOLT AA 






Initializer 
OLTS Running 




r^ 








^ 














IJZAD052 AE 




IJZAD033 AN 




1JZAD037 BQ 




Communication 
Interval 


Message Options 


Enter 

DEV/TE ST/OPT 




' 






























1 



IJZAD031 AH 



Device Decode 



1JZAD032 AK 



Reply 
PROMPT 



Reply 
DUMP 



Reply = 
CANCEL 



Reply = 
RE I 



Reply 
STOPREI 



Reply 
EQU 





iJZADOZl CN 


.YES ^ 


Print PROMPT 
Messages 







IJZAD052 AE 


YES 


Dump Background 
Partition 





IJZAD057 AG 



iJZAD076 CR 





IJZADOZa CT 


YES 


REI Terminate 







IJZAD049 CE 


.YES ^ 


EQUATE 






& 



IJZAD033 AN 



Option Decode 




IJZAD056 AS 



Data Protect 
Routines 



■(Terminate OLTEP j 






IJZADOOO AP 



IJZADOOO AP 



Scheduler Return 




IJZAD057 


AGl 


Tape Label 
Restore 




IJZAD016 


BE 


Get CDS 
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Chart AA. UZADOLT: OLTEP NUCLEUS (Part 1 of 9) 



IJZADOLT 



CAT "i ^ ^ " AZ x ^ 

EXIO j ( EPPADOTM j 
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Chart AA, IJZADOLT: 

01K4 



-A1- 



OLTEP NUCLEUS (Part 2 of 9) 



SAVE ALL VALUES 
AT TRANSIENT 

DIRECTORY ENTRY 

POINTED TO BY 

R8 



-B1- 

PiqjC UP ENTRY 

POINT FROM 

TRANSIENT 

DIRECTORY TABLE 



r"' ^ 

f ALTRET1 j 



MRC4 1 
I— B2-^ 



SET RETURN CODE 

TO 4: FORCE AN 

APPARENT LOAD 

ONLY REQUEST 




SAVE WORK 

REGISTERS AND 

MACRO REGISTERS 
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Chart AA. UZADOLTs 0L1EP NtKLEDS (Part 3 of 9) 



(^ ^ 

f EPZAD098 1 
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Chart i^i^. IJZAD0L1: OLIEP NUCLEUS (Fart 4 of 9) 



, 03D3 
1 04 I 03E5 
All 03F5 
03H5 



POST TECB 




IS THE ^S.NO 
EVENT CTR 
FULL? 



PICKUP TECB 
POINTER 





IS TECB FULL 



CALCULATE ADDR 

OF TECB ENTRY 

FOR POSTING 



SET CE, DE ON 
SET CC=1 



U 



s 




POST SIO 
CONDITION CODE 




SET CSW POSTED 

INDICATOR IN 

TECB 




POST STATUS 

FROM CSW TO 

TECB 



L 







L 








CALCULATE SENSE 

FLD ADDR FOR 

POSTING 



PUT CMND FLD IN 
SENSE CCW 



-B4- 



X TURN ON 
/SUPRESS WRONG 
< LENGTH 
\lNDICATOR BIT, 
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Chart AA. IJZAEOLT: OLTEP NUCLEUS (Part 5 of 9) 



04K5 



SIOLOOP 



REISSUE 'SIO' 



/TURN OFF CU\ 
/ END, BUSY, > 
<STATUS MODIFER ^ 



'OR' THE STATUS 

WITH CSW STATUS 

STORED 




04H4 
04H5 
04K4 



RESTORE THE CSW 
FROM REGISTERS 



/ SET EVENT 
C COMPLETE BIT 
\ $EVNCPLT 



<^I?IPF?^ 


YES 


\. 


^ 


l04 
1 G5 




^ 




y^\S TECB^X 
C EVENT CTR J 
^S^ FULL y/^ 


YES 


\ 


Xo 


1^ 


, 






UPDATE THE 
EVENT COUNTER 







yP-F4 T » . 

/ TURN OFF \ 

^ ERROR STATUS ^ 
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Chart RR. UZADOLT: OLTEP NUCLEUS (Part 6 of 9) 



f EPZAD094 j 



SET UP TO 
SEARCH DEVTAB 
FOR INTERRUPT 




POST EVENT CODE 

AND I/O ADDR IN 

ECB 



ZERO OUT 8 
BYTES IN TECB 



MOVE INT CODE 

FROM LOW CORE 

TO TECB 



INCREMENT 

DEVICE TABLE 

PTR TO NEXT 

ENTRY 
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Chart hii. IJZADOLT: OLTEP NUCLEUS (Part 7 of 9) 




►0 
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Chart Ai^. IJZADOLl: OLTEP NUCLEUS (Part 8 of 9) 



GET OLT AREA 
SIZE IN WORDS 



$MODSIZE 08A1 



GET HIGH ADDR, 

LEN OF NEW LCL 

CDS PHASE 




$MODSIZE 09A1 



GET HI ADDR, 

LEN OF OLD LCL 

CDS PHASE 





CDS PHASE 




y— H1- 
/SET NO^REMOTEN 
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Chart AA. 



UZADOLT: OLTEP NUCLEUS (Part 9 of 9) 



LTCOMN 
^-Al . 

f $MODSIZE 1 



PUT IN DEFAULT 
IN BUFFER 



GET MODULE 

LOAD POINT 

(SVC 51) 



CALCULATE 

LENGTH AND HIGH 

ADDRESS 



G 



1 



r~ ^ 

i OLDBADDV 1 



r"' — \ 

f I PRINT j 



SET RO TO 4 



C-C3' 
$DT 




3 



STORE RO IN 
PARAMETER LIST 
(ACTION VALUE) 



SET RO EQUAL TO 

THE CONTENTS OF 

R15 



G 



EXIT TO 
IJZADOOO 



3 



PRNTLNTH i r 



r~^ — 7 

/ PRINT MESSAGE / 
/ ON SYSLST / 
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Chart AE. IJZAC052: Ccirmuni cations Interval (Part 1 of 3) 




Charts 65 



Chart AE. IJZAD052: Coirmuni cations Interval (Part 2 of 3 ) 



NO 


IJZAD037 BQ 


ISSUE MESSAGE 
E166I 





'°]3 
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Chart AE 



Coirmuni cations Interval (Part 3 of 3) 





1 



BQ 



BQ 



c 



) 
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Chart AG. IJZAD057: Restore Tape labels (Part 1 of 2) 





A57BACK 




68 DOS/VS OLTEP Logic 



Chart AG. IJZAD057: Restore Tape labels (Part 2 of 2) 




UPDATE DEV PTR 




IJZAD037 BQ 
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Chart AB. IJZAD031: Device Decode (Part 1 of 3) 



f EPZAD03 1 j 





-»<^NDR SPECIFIED 



© 



Li 



J03\ 



SET UNIT 

ADDRESS ENTRY 

FLAG 



COMPUTE ENTRY 
LENGTH 



CLEAR DEVICE 
TABLE 





YES ^ 


IJZAD037 BQ 


ISSUE MESSAGE 
E252I 





PUT UNIT 

ADDRESS IN 

CONVERT WORK 

AREA 



U, 



E> 



y^ET INCLUSIVe\ 
/ RANGE FLAG >< 
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Chart AE. IJZADOSl: Device Decode (Part 2 of 3) 





PUT CDS 

INFORMATION IN 

DEVICE TABLE 





(TSET 'NO CDS' 
FLAG 



PUT SYMBOLIC 

NAME IN MESSAGE 

E127I 



PUT DEVICE 

ADDRESS IN 

TABLE 



BQ 



L 




DUPLICATE ^>S, NO 
DEVICE ENTRY 



GET POINTERS 

FOR SYSTEM LUB 

CHECK 




GET NICL S FICL 

TABLE POINTER 
FOR OLTEP LUBS 




GET PUB POINTER 
FOR THIS LUB 







CONVERT DEVICE 

ADDRESS FOR 

MESSAGE E234I 




BQ 



ISSUE MESSAGE 
E234I 



Li 



CONVERT UNIT 

ADDRESS TO 

EBCDIC 



BQ 



BQ 



ISSUE MESSAGE 
E235I 
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Chart AB. IJZAD031: Device Decode (Part 3 of 3> 

, 02H3 



PUT LUB 
ASSIGNMENT IN 
DEVICE TABLE 



NO yr IS TEST 

DEVICE READD 
DEVICE 



'NO CDS' 
FLAG ON ? 



HAS A 
TESTABLE 
DEVICE BEEN 
ENTERED ?^ 



f SET 'MULTI 

DEVICE ENTRY' 
V FLAG 



y^ET 'TESTABLeS 
CDEVICE entered', 
X FLAG y 




G31EN08 ir 
■E2- 



^INDICATE END , 

<0F DEVICE TABLE, 

ENTRIES 



L 



© 



SET DEVICE 
CHANGE FLAG 







r" — \ 

f IJZAD032 \ 



UPDATE 
INCLUSIVE RANGE 
DEVICE COUNTER 




'°i5 >^ 



UPDATE DEVICE 

TABLE ENTRY 

POINTER 



01C4 
01D5 
01E3 
01E4 
FNOTE 



MOVE ERROR 

ENTRY TO 

MESSAGE El 081 




BQ 



ISSUE MESSAGE 
E108I 



01H4 
02K2 



BQ 



BQ 




/ RESET VALID \ 
/ DEVICE FLAG > 
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T0:E5 T0:E5 

01E5 01K5 

01F3 02C1 

01F5 

01H1 

COL 5 



Chart AK. IJZAD032s Test Decode (Part 1 of 3) 




A32SETR6 w 
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Chart AK, 



IJZAIX)32: Test Decode (Part 2 of 3) 




T0:E5 

0lF4 

01G1 

01H4 

01K1 

01K5 
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Chart AK. IJZAD032: Test Decode (Part 3 of 3) 



RTNDC f 



02E3 
02G3 



PUT ROUTINE # 
IN SCT 




-^^AST ROUTINE?^ 

^Sm/YES 






PUT LAST ENTRY 

INDICATOR IN 

SCT 



Li 





-E3- 



IJZAD037 BQ 



ISSUE MESSAGE 
E155I 




-H3- 



01C2 
02J1 



/ SET VALID 
►< ENTRY FLAG IN 
X SCT 



f IJZ 



3 



i 



GET NEXT 

CHARACTER 

ADDRESS 



''IS NEXT 
CHAR IN ^S^NO 
WORK AREA I A^ 



MOVE AN A INTO 
WORK AREA I 



Ui 



Li) 



Li 



Charts 75 



Chart AN. IJZAD033: Option Decode (Part 1 of 3) 

L33DECOD 



r' N 

f EPZAD033 1 





OPTION ^S^NO 
[^MESSAGE TO BEj^ 
^ ^PRINTED ?^ " 



NOTE: THIS MODULE DOES AN 
INDEXED EXECUTE INSTRUCTON 
ON ONE OF TWO TABLES TO 
SET OR RESET AN OPTION. 
THE FOLLOWING BLOCKS ARE 
EXECUTED FOR THE OPTION 
INDICATED INSIDE THE BLOCK 



UPDATE PUFFER 

POINTER TO NEXT 

CHARACTER 



TL: PROCESS THE 
LOOP COUNT 



y^K 



SET UP FOR 

SCANNING ALL 

OPTIONS 



A33CHKNX n 



SET UP FOR 

SCANNING ALL 

OPTIONS 



EL: PROCESS 
COUNT FIELD 



PP: PROCESS THE 

PARALLEL PRINT 

LEVEL 



-D2- 



POINT TO 

CURRENT LETTER 

AND POSITIVE 

OPTIONS 



NPP: RESET 

THE PARALLEL 

PRINT BIT 





y— E3- 



PUT IN AN 'N' 



/mI: 
01ANUA 



.-_: SET THE 

.NUAL INTERV. 

BIT 



/— FA- 
RE SET NO ' 
<ERROR PRINT BIT> 



Tep: : 

OIRROR 



POINT TO LETTER 

AFTER 'N' AND 

NEG. TABLE 



^P3 . 

/ NMI : RESET \ 
< THE MANUAL > 
\ INTERV. Bin / 




X NT] 
-<^THE 



NTL: RESET 

THE TEST LOOP 

BIT 




, NFE: RESET 
<THE FIRST ERROR> 
^ BIT ^ 



r— E5" 

/cP: 

-^CONT 



SET THE 
CONTROL PRINT 
BIT 



NOP: RESET 

THE CONTROL 

PRINT BIT 
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Chart AN. 



IJZAD033: Option Decode (Part 2 of 3) 

01G2 
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Chart Ml. 1JZAD033: Option Decode (Part 3 of 3) 



. 01J3 
|03 I 01K4 
All 02D1 




ISSUE MESSAGE 
El 761 VIA 
IJZAD037 



Ll 



/RESET $CATERR* 
^ BIT IN SCT 



/RESET FIRST' 
ERROR AND 
, CATASTROPHIC 
BITS 



f RETl 




$caterX 
IN SCT y 



RETURN TO OLT 



) 



SET ACTION 
VALUE TO 



X RESET FIRST 
C ERROR BIT 







© 



a 



SET ACTION 
VALUE TO 1 



A33SCHD 



/iJZi 



IJZADOOO VIA 
IDTRMLNK 



) 




RESTORE OLT 
REGISTERS 



ABRAl 
( FOR 



BRANCH ON R15 
OLT FUNC 



D 
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Chart AP. IJZADOOO: 



Scheduler (Part 1 of 4) 

03G3 




****** «««**«««**« *******«« 
* ACTION VALUES * 

- RESET ALL POINTERS; 
BEGIN SCHEDULING. 
f - TERMINATE ACTIVE OLT; 
CONTINUE SCHEDULING. 

2 - NORMAL RETURN FROM 
OLT. 

3 - OLTEP 2 -WAY MESSAGE 
WITH NO CONSOLE: CAN- 
CEL ACTIVE OLT OR 
CONTINUE SCHEDULIN 
NEXT DEVICE IF NO OLT 
IS ACTIVE. 

4 - RETURN FROM OLD OLT 
BECAUSE OLT COULD NOT 
TEST PRIMARY DEVICE. 

5 - NORMAL RETURN FROM 
DATA PROTECTION, 

6 - NORMAL RETURN FROM 
READ TO FLUSH CARDS. 
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Chart M>. IJZADOOO: Scheduler (Part 2 of U) 
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Chart AP, 



IJZADOOOj 



Scheduler (Part 3 of 4> 



. 02C1 

03 I 02G2 

A4I 02K2 




FORMAT AND 
PRINT El 581 



U 







r \ 

( AOORESET V 



SET TEST LOOP 
COUNT TO ZERO 



CE 



J 



ADD ONE TO LOOP 

COUNT; RESET 
DEVICE POINTER 



f AOi 



3 



STEP DEVICE 

POINTER: RESET 

TEST POINTER 



( A001 



D 



STORE ALL THREE 

POINTERS IN 

COMMON 



f REl 



3 
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Chart AP. UZADOOO: Scheduler (Part H of 4) 



f AOOE201I j ( AOOSTMSG J 



/set 

C^ BIT 



G 



1 





PUT "$" IN 

MESSAGE AS AN 

IDENTIFIER 



ISSUE MESSAGE 
E158I 



©- 

CG5 
RE 



J 
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Chart AS. 

IJZAD056 



IJZAD056: Data Protect (General) (Part 1 of 2> 




f B56SAVE V 



r~ — 7 

/ ISSUE TIO TO / 
I TEST DEVICE I 



f RE' 



RETURN VIA 
SUPERVISOR 



J 
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Chart AS, 



IJZAD056: Data Protect (General) (Part 2 of 2) 



f IJZAD003 J 




DISK 

^E5 ^^ 

f IJZADO07 j 



MSGE E199D 
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Chart AU. 



UZADO02S Data Protect (2321) 
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Chart AV. IJZADO03: Data Protect (Tape) (Part 1 of 2) 
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Chart AV. IJZAEX)03: Data Protect (Tape) (Part 2 of 2) 
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Chart AX, IJZADO07: Data Protect (2311/2314) 
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Chart AY. IJZADOII: TP Line Connection (Part 1 of 4) 
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Chart AY. 



IJZAD011 : 



TP Line Connection (Part 
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Chart AY. IJZAD011: TP Line Connection (Part 3 or 4) 
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Chart AY. IJZAD011: TP Line Connection (Part 4 of 4) 




Charts 91.1 



Chart BR. IJZADOIO: REI Nucleus (Part 1 of 4) 
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Chart EA. 



IJZADOIO: REI Nucleus (Part 2 of 4) 
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Chart BA. IJZADOIO: REI Nucleus (Part 3 of *») 
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Chart Bh. 



IJZAIX)10: REI Nxicleus (Part 4 of 4) 
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IJZAD016: GETCONFG (Part 1 of 2) 
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Chart BE. IJZAD016: GETCONFG (Part 2 of 2) 
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Chart BP. IJZAD021: GRAB (Part 1 of 3) 
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Chart BI. UZAD021: GRAB (Part 2 of 3> 
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Chart BF. IJZAD021: GRAB (Part 3 of 3) 
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Chart BE. 



IJZAD022: ALOCAl 
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Chart EJ. 



IJZAD02a2 READD (Part 1 of 2) 
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© 1 



Chart BJ. IJZAD024: READD (Part 2 of 2) 
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Chart BL. IJZAD026: LOGSCAN (Part 1 of 3) 
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Chart BL. IJZAD026: LOGSCAN (Part 2 of 3) 
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Chart BL. IJZAD026: LOGSCAN (Part 3 of 3) 
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Chart BM, IJZAD028: PL INK 
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Chart BN. IJZAD035: EXIO (Part 1 of 3) 
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Chart BN. IJZAD035: EXIO (Part 2 of 3) 
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Chart BN. 



IJZAD035: EXIO (Part 3 of 3) 
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Chart BP. IJZAD036: WAITIO (Part 1 of 3) 
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Chart BP. IJZi^D0 36: 



V^AITIO (Part 2 of 3) 
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Chart BP, 



IJZAD036: WAITIO (Part 3 of 3) 
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Chart BQ, IJZAD037s CECOM (Part 1 of 3) 



r~ ^ 

f EPZAD037 \ 




NO ^/^ ^N^ 

< — ^OVER LENGTH^ 




A IJZADOOO VIA 

( $DTRMLNK )♦- 



y 



,1 



L37PPRNT 03A2 



OUTPUT MESSAGE 

TO SYSLST, 

REMOTE 




L37LOGOT 03A4 




SET ACTION 
VALUE TO THREE 




Page of SY33-8568-0, Revised October 31, 1973, By TNL: SN28~2567 



Chart BQ. IJZAD037: CECOM (Part 2 of 3) 
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Chart BQ. 



IJZAD037: CECOM (Part 3 of 3) 
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Chart BS. IJZADOo9: DPRINT (Part 2 of 3) 



I I 01E3 
|02 1 01F3 
I All 01H1 






^K. \ 

I A61TEST j 



NO 
< 


V^RINT CCW, X,^ 
r CC OR CSW ^ 


\ 


^TES 


L39PCCW 






IJZAD062 CG 


PRINT CCW, CC 
OR CSW 


L39£ 


n. 

5NSPR ^ 


N. 



PRINT 
DESCRIPTION 




SET UP POINTERS 

FOR ROUTINE TO 

PRINT 



SET UP POINTERS 

FOR ROUTINE TO 

PRINT 



PUT DEVICE 

ADDRESS IN CAT 

ERROR MESSAGE 



/ RESET PARM \ 
^IST ERROR FLA(^ 



A61TEST 02A4 



L 







118 DOS/VS OLTEP Logic 




Chart BS. IJZAD039: DPRIN1 (Part 3 of 3) 
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Chart BT. IJZADOaO: $MODE 
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Chart BU. IJZAD041: CONVERT 
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Chart BV. 

IJZAD042 



IJZAD04 2: MORECORE 
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Chart Ch. IJZAD043: FREECORE 
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Chart CB. IJZAD044: DIG (Part 1 of 2) 
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Chart CE. IJZAD044: DIO (Part 2 of 2) 
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Chart CC. IJZAD045: Trace/Return Code Handling Module 
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Chart CE. IJZADOU?: Routine 
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Chart CE. IJZAD049: Equate (Part 1 of 2) 
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Chart CE. IJZAD049: Equate (Part 2 of 2) 
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Chart CG. 



IJZAD062: 
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Chart CG. IJZAD062: CC1&^- Message (Setup) (Part 2 of 4) 
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Chart CG. IJZAD062: CCW Message (Setup) (Part 3 of *») 




f A63PNT j 



L62PRINT 03F5 



G 



J 



( L62PRINT j 



ISSUE BUFFER 



G 



3 



A63GOPRT 

— J3- 
A63PNT 



EXIT 1 r 

^K3 ^^ 

I RETURN ) 



■0 

132 DOS/VS OLTEP Logic 



Chart CG. UZAD062: CCW Message (Setup) (Part 4 of U) 
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PROVIDED 



A63460 
-r — >l EXIT VIA R11 j 



MOVE COUNT INTO 
BUFFER 





GET FIELD 

LENGTH & PTR TO 

FIRST ENENT 




INCREMENT EVENT 
FIELD PTR BY 
FIELD LENGTH 




SET PARMLIST 
ERROR BIT ON 



©- 




RESET CSW2 FLAG 

NEXT CSW IS THE 

ONE WANTED 



z^" ^ 

-►fRETURN VIA RIO j 
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Chart CK. IJZAD064: Sense Data Message (Seti:ip> (Part 1 of 2) 





^A1 ^^ 

( EPZAD064 J 





PUT 'XPTD 
SENSE' IN 



i 



^ SET DPRINT 
<PARAMETER LIST 
ERROR BIT 



A64218AA 01A5 



ISSUE PRINT 




f A64218AA j 



SET FIELDS TO 
CHECK EQUAL TO 

NUMBER OF 
SENSES OCCURED 





XsT LIST OH \y^ 


NO 


^ 


y^s 






MOVE * TO MSG 




210B 


. 1 


A64218AA 01A5 




ISSUE PRINT 





Ui 



B 




SET OUT COUNT 
TO MAXIMUM 



PUT OUT COUNT 

IN PARAMETER 

LIST 



FORMAT LINE TO 
PRINT 



CALL IJZAD070 
TO PRINT LINE 
JUST FORMATED 



SUBTRACT BYTES 
PRINTED FROM 
OUTCOUNT LEFT 




Chart CK. IJZAD064: Sense Data Message (Setup) (Part 2 of 2) 



c 



SET DPRINT 

PARAMETER LIST 

ERROR BIT 
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Chart CM. IJZADO702 Output Writer 
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Chart CN. IJZAD071: Prcirpt Device 



r' ^ 

( IJZAD071 1 



GET INITIAL 



CLEAR WORK REGS 



GET ADDR OF MSG 
MASK 



©- 

A71INLP 



GET LINE LENGTH 



©^ 

1SKIP 4r 
■ A 3-J- 



UPDATE LINE 
POINTER 





G 



EXIT TO 
IJZAD052 



3 
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Chart CR. 



IJZAD076: REI Initializer #1 



r' \ 

( IJZAD076 1 



^YES 




IJZAD037 BQ 


MESSAGE El 631 









RESET 
OUTSTANDING 
EXECUTIVE 
^REQUEST FLAG 



> 



.-ESET ERRORN 
FLAGS: SET 

:tion value to> 



flJZl 



IJZADOOO VIA 
$DTRI4LNK 



) 
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Chart CS. IJZADO??: REI Initializer #2 



r' \ 

( IJZAD077 j 



31- 



ALLOCATE 
BACKGROUND 

SPACE FOR 
RETAIN/ 370 



^-C1 



I ACT 



ET REI 
ACTIVE FLAG 



LOAD AND 

RELOCATE REI 

NUCLEUS 




ADD TO CURRENT 

TIME THE NUMBER 

OF SECONDS TILL 

TIMOUT 




SET 'REI 
<ACTIVE' FLAG IN; 
>^ SOT 



MESSAGE El 631 



A IJZAD052' j 
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Chart CT, IJZAD078: RETAIN/SIO Terminate 





SET LOCAL 

PRINT ONLY 

SWITCH 



BQ 



BQ 



ISSUE HSSSAGE 
El 371 



L78NWAIT 



SVC 25 TERM 
REMOTE READ 




RESTORE 

EFFECTIVE 

PARTITION SIZE 



/ \ 

«.ESET REI FLAG^ 




BQ 



MESSAGE El 69 I 



L78EXIT 






J 
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Chart DA. 



UZADOAA: $DDATE 

-B2- 



( IJZADOAA j 



/ SE' 
C CO] 




GET DATE FROM 

THE 

COMMUNICATIONS 

REGION 



RESTORE 
CALLER'S 
REGISTERS 



f RE 




REFORMAT DATA 
TO MM/DD/YY 



3 
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Chart DB. UZADOAB: $DTIME 



f EPZADOAB y 



SET RETURN 
CODE= 4 




{ RETURN j 
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Chart DD. UZAOLTP: $$BOLTEP 




SET OLTEP 
BIT ON IN 
SYSCOM (BYTE 
^ 108, BIT 0) 



G 



y 



TRY TO ISSUE 
APPROIATE I/O 

COMMAND 




ISSUE ENABLED 

SVC 22 TO 

RELEASE 

SYSTEM 
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Chart DE. IJZA10LT: $$BT0L1P, Terminate OLTEP 



r IJZATOLT A 

VIJbtoltp J 



GET COMM 

REGION 

ADDRESS VIA 

COMRG MACRO 



SET UP CCW TO 
FLUSH INPUT- 
SAVE OLTEP REGS 



SAVE REGS, INT 

CODE FROM PIB 

AND PHASE 

NUMBER 













SVC 9 TEMP 

EXIT FROM 

B -TRANSIENT 

STATE 





INITIALIZE 
REGISTERS 



L 



RESTORE REGS, 

INT CODE FROM 

PIB , PHASE 

NUMBER 









INITIALIZE LUB, 
PUB, AND QUEUE 
TABLE POINTERS 



SVC 46 ENTER 

SUPERVISOR 

STATE 



SAVE SUPERVISOR 

REGS. RESTORE 

OLTEP REGS 



SET RETURN ADDR 
TO L$BCPERR 
i1E4): SET 

ACTION VALUE = 
1 



C 



IJZADOOO VIA 
$DTRMLNK 



) 
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Chart DJ. IJZADOAJ: $Ct]TESl (Part 1 of 3) 



r~^' ^ 

f EPZADOAJ \ 






U 








GET SYSTEM 

DEVICE LUBS, 

INITIALIZE 

POINTERS 



©- 

LAJLOOP 

'IGN' 



^^ DEVICE IN^ 
C EXTENT 


^YES 




LAJSTR 03A2 


PUT DEVICE 

ADDRESS IN 

MESSAGE E244I 


^ 




^ 


^^Q 














LAJUPDT 




> 






/ UPDATE ^ 

C INTERNAL LUB 
\ POINTER A 






— H3- 

WAJRTR 



ISSUE 'SYSTEM 

DEV MESSAGE 

(E244I] 




/ RESET \ /" A 

j ►INTERNAL FLAGS \ >i RETURN 1 



K3l 02J5 
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Chart DJ. IJZADOAJ: $CVTES1 (Part 2 of 3) 




il^° » 


IJZAD041 BU 




IJZAD037 BQ 


CONVERT DEVICE 


ISSUE 'NO CDS' 
MESSAGE (El 271) 







L 




ISSUE 'CPU 

SHARED' MESSAGE 

(E244I) 



BQ 



ISSUE MESSAGE 
E243D 



IJZAD037 BQ 


4 ERR 


ISSUE MESSAGE 
E199D 
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Chart DJ. IJZADOAJ: $COTEST (Part 3 of 3) 



( LAJSTR j 




SET MESSAGE 
FLAG 



CONVERT DEVICE 

ADDRESS TO 

EBCDIC 



/ UPDATE LIST \ 
C POINTER y 






G 



3 




ISSUE HEADER 

LINE FOR 
MESSAGE E244I 



BQ 



ISSUE DEVICE 
LIST LINE FOR 
MESSAGE E244I 



/RESET LIST 

POINTER AND 

MESSAGE FLAG, 

VCLEAR BUFFER 



c 



3 
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Chart lA. IJZACBOMs CE Coiniruni cation 




MOVE RETURN 
DATA TO OLT VIA 
AN EXECUTE INST 
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Chart ED. UZACX)MP: Coirpare 



*A3 
AT PRESENT, THIS TEST 
DOES NOT APPLY TO 
DOS/TOS. IT IS LEFT IN 
THE LISTING FOR 
COMPATABILITY PURPOSES 
WITH AN OS OLTEP PROGRAM. 
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Chart EE. UZACONV; Convert 



r~ ^ 

C UZACONV I 



SAVE CALLER'S 

REGISTERS 

INITIALIZE BASE 

REG 



INITIALIZE REGS 

WITH 'FROM 

ADDR ' ' TO 

ADDR', AND 

COUNT 




DOUBLE COUNT 

FOR OUTPUT AND 

ADD TO INPUT 



CHANGE TO 

EBCDIC AND 

STORE 



SET UP REG WITH 
EBCDIC ADDR, 

AND INITIALIZE 
TABLE SEARCH 
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Oiart EF, MZADOLD: Old EXIO, WAITIC, DPRWT (Part 1 of 3 ) 



ZADOLD 

r"'' ^ 

f EPZADOLD J 



GET THE VALUE 
OF R1 AT THE 
TIME OF CALL 






SET UP CCB: 

ZERO SENSE & 

TECB; GET CCW 

ADDR S PUT IN 

CCB 




, SET FIRST , 
/^CATASTROPHIC 

AND 
^CATASTROPHIC 

\PRINT BITS 



POINT TO WRITE 

OP CODE TABLE; 

GET NUMBER OF 

OP CODES 




BQ 



STEP TO NEXT OP 
CODE: REDUCE 
COUNT BY ONE 



SET FIRST 

ERROR AND 

FIRST ERROR 

PRINT BIT 



SET ACTION 

VALUE TO ONE TO 

TERMINATE OLT 




AlJZADOOO VIA 
( IDTRMLNK 



) 




L 



© 






SETUP PARM. 
LIST FOR 
IJZADO70 



•B4- 



SET TWO 

BITS TO 

CORRESPOND TO 

THE PP LEVEL 

NUMBER 



'°i«: 



BLANK BUFFER; 
SET MESSAGE 
LEVEL TO 



GENERATE 

CONTROL 

CHARACTER OP 

CODE 



CALL FOR FORMS 
CONTROL 



©^ 

DHDNER 4r 
A5-1- 



PUT IN TEST 

SECTION ID; PUT 

IN ROUTINE 

NUMBER 



CONVERT ADDRESS 

PASSED TO 

EBCDIC 





PUT AN "*" IN 
HEADER 



L 
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Chart EF. MZADOLD; Old EXIO, WAITIC, DPRWT (Part 2 of 3 ) 

;© I 1 © 




/ SET 
^ LEVE 



PUT "RCVD" IN 
MESSAGE 



CONVERT DATA 

THAT MAY BE 

PRINTED 




PUT CONDITION 
CODE IN MESSAGE 




PUT ALL CSW 
FIELDS IN 
MESSAGE 






MOVE ADDRESS 
INTO FIELD 




PRINT FORMATTED 
LINE 



PUT "XPCTD" 
MESSAGE 



CONVERT DATA 

THAT MAY BE 

PRINTED 





MOVE IN CSW 
MASK WITH "X" 
IN ALL FIELDS 



L 



© 
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MOVE RESIDUAL 

COUNT INTO 

FIELD 




MOVE SENSE 

BYTES INTO 

MESSAGE 



PICK UP COUNT 
SPECIFIED 



CONVERT DATA 
INTO MESSAGE 




PICK UP MAX 

COUNT INSTEAD 

OF COUNT 

SPECIFIED 



MOVE MESSAGE 
INTO BUFFER 




01G5 
01H5 



PRINT THE 

FORMATTED 

BUFFER 




L 



FORMAT FIELDS 
OF MESSAGE 

E129I 



BQ 



ISSUE MESSAGE 
E129I 




BQ 



( IJZAD052 ) 



Chart EF. UZAEX)LD: Old EXIO, WIITIC, DPRWT (Part 3 of 3) 



ISSUE WAIT 

MACRO TILL 

I/O IS 

COMPLETE 



MOVE CSW FIELDS 

AND SENSE INFO 

INTO TECB 



01D2 
01E2 
01J3 
02A5 



RESTORE R1 TO 

VALUE AT TIME 

OF CALL; 

RESTORE R2-Ria 



G 



1 




f ALDMVDTA V 



-B3- 



CALCULATE 

BUFFER ADDR AND 

MAX LENGTH: GET 

BYTE COUNT 

GIVEN 




CONVERT DATA 
INTO MESSAGE 



G 



f ALDPRNTL j 



PRINT FORMATED 
BUFFER 



G 



) 



) 
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Chart mi. UZAOPUT: Output 



( UZAOPUT j 



/put 

y COUN 
OARAME 



PUT BYTE 
^ COUNT INTO 
<PARAMETER LIST 



BQ 



PRINT OLT 

MESSAGE VIA 

IJZAD037 



OUTPUTEX y r 
-E2. ^ 



RESTORE 
REGISTERS 



G 



J 
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Chart EN. UZ2VRATA: Random Data Generator 



r~ ^ 

f EPZARATA \ 



SAVE CALLER'S 

REGS, ESTABLISH 

BASE REG 



,1 



MOVE RANDOM 
NUMBER INTO SCT 



GET CALLERS 

BUFFER ADDR AND 

COUNT 



MOVE DESIRED 

DATA INTO 

CALLERS BUFFER 




MOVE DATA FROM 

SCT INTO RANDOM 

DATA AREA 



0- 

RDA001 



RESTORE 
REGISTERS 



^^«— E' 



3 



F4 
RDA002 



002 1 



MOVE 4 
CHARACTERS INTO 
CALLERS BUFFER 



INCREMENT ADDR 

OF CALLERS BUFF 

BY 4 BYTES 

MOVED 



STORE NUMBER IN 

RANDOM DATA 

AREA 



DECREMENT 

AMOUNT TO MOVE 

BY 4 




L 



© 
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Appendix A: OLTEP Message Cross Reference 



for complete message and respcnse, refer to the DOS CLTEP 
piablication listed in the Preface . 






Message 
Number 



ElOOI 

04E101D 

E10 2I 

01E10 5D 

E106I 

E107I 

E108I 

EllOI 

ElllI 

E112I 

04E113D 

E115I 

E117I 

E118I 

E119I 

04E120D 

E122I 

E122I 

E122I 

E124I 

E125I 

El 26 1 

E127I 

E127I 

E127I 



Message 

information message from the olt 

(reguest from the OLT) 

OLIS RUNNING 

ENTER DEV/TEST/OPl 

INPUT DATA DOES NOT CONTAIN 3 SLASHES 

OPTIONS ARE XXX, XXX 

INVALID ENTRY IN DEV FIELD- XXXXXXXX 

TESTABLE DEVICES MAY NOT EXCEED 16 

NO DEVICES AVAILABLE FOR TEST 

INVALID ENTRY IN TEST FID-XXXXXXXX 

CAN CTL PGM ON MULTI-ADDR DEV XXXX BE DESTROYED REPLY 
YES/NO 

INVALID ENTRY IN OPT FIELD- XX XXXXXXXX 

SECTION XXXXXXXX NOT FOUND 

UNREADABLE TAPE LABEL- XXXX 

NON-STANDARD TAPE LABEL-XXXX 

CAN VOL DATA ON XXXX BE DESTROYED. REPLY ^ YES OR NO 

VOL ON XXXX SECURITY PROTECTED 

VOL ON XXXX SECURITY PROTECTED 

VOL ON XXXX IMEXPIRED DATE 

CEPACK NOT ON XXXX, VOLID=XXXXXX 

UNREADABLE LABEL ON XXXX 

BIN OF XXXX DOES NOT INDICATE CE CELL 

NO CDS FOR XXXXXXXX 

NO CDS FOR XXXXXXXX 

NO CDS FOR XXXXXXXX 





1 ^)Of"x 


Issuing 
Rcutine 


Chart 
IE 


OLT 


BS 


OLT 




UZAEOLT 


AA 


IJZAE052 


AE 


UZAD052 


AE 


UZAD033 


AN 


UZAD031 


AB 


UZAE031 


AB 


UZAD031 


AB 


UZAD032 


AK 


UZAC056 


AS 


IJZAD033 


AN 


UZADOOO 


AP 


UZAEO03 


AV 


UZADO03 


AV 


UZAD022 


BE 


UZADO03 


AV 


UZADO07 


AX 


UZADO03 


AV 


UZADO07 


AX 


UZADO07 


AX 


UZABO02 


AU 


UZADOOO 


AP 


UZAD031 


AB 


UZADOAJ 


EJ 
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E129I 

E129I 

E130I 
E130I 
E131I 
E132I 
E134I 

E137I 

E137I 

E137I 

E137I 

E137I 

E137I 

EOS I 

04E139D 

04E139D 

04E139B 

04E139D 
04E139D 
04E139D 
04E145D 

E147I 
E148I 
E149I 
E155I 
E157I 
E157I 
E158I 
E158I 
E161I 
E161I 
E161I 



FIRST ERROR COMM XXXXXXXX XXXX UNIT ZZZ DDDDDDDD 

FIRST ERROR COMM XXXXXXXX XXXX UNIT ZZZ DDDDDDDD 

INTERVENTION REQ XXXX 

INTERVENTION REQ XXXX 

SENSE TO XXXX FAILED 

CE BIT WILL NOT BE RESET - XXXX 

WARNING ~ DASD VOLUME LABELED CEPACK NOT PROTECTED FROM 
WRITE 

CSW-ZZ...Z SNS-XX. ..X 

CSW-ZZ...Z SNS-XX. ..X 

CSW-ZZ.,.Z SNS-XX...X 

CSW-ZZ...Z SNS-XX. ..X 

CSW-ZZ...Z SNS-XX. ..X 

CSW~ZZ.*.Z SNS-XX.«eX 

DEV XXXX NOT OPERATIONAL, CC=3 

REPLY B TO BYPASS, R TO RETRY, P TO PROCEED 

REPLY B TO BYPASS, R TO RETRY, P TO PROCEED 

REPLY B TO BYPASS, R TO RETRY, P TO PROCEED (MAY 
DESTROY DATA) 

REPLY B TO BYPASS, R TO RETRY 

REPLY B TO BYPASS, R TO RETRY, P TO PROCEED 

REPLY B TO BYPASS, R TO RETRY, P TO PROCEED 

IS XXXX OFFLINE TO ALL SHARING SYSTEMS? REPLY YES OR 
NO 

EXAMPLES OF DEVICE FIELD 

EXAMPLES OF TEST FIELD 

TABLE OF OPTIONS 

TEST SECTIONS MAY NOT EXCEED 26, WILL TEST XXX-XXX 

CATASTROPHIC ERROR ON DEVICE XXXX DDDDDDDD 

CATASTROPHIC ERROR ON DEVICE XXXX DDDDDDDD 

S(T) XXXXXX ($) UNIT YYYY 

S(T) XXXXXXXX UNIT YYYY DDDDDDDD 

FOR HELP, ENTER PROMPT DEV TO NEXT DEV/TEST/OPT/MESSAGE 

FOR HELP, ENTER PROMPT TST TO NEXT DEV/TEST/OPT/MESSAGE 

FOR HELP, ENTER PROMPT OPT TO NEXT DEV/TEST/OPT/MESSAGE 



IJZAD039 


BS 


IJZADRPT 


EF 


IJZi^D056 


AS 


IJZAEO02 


AU 


IJZAEO02 


AU 


IJZADO02 


AU 


IJZADOLT 


AA 


IJZAD056 


AS 


IJZADC02 


AU 


IJZADC03 


AV 


IJZADC07 


AX 


IJZAD057 


AG 


ICJZAD078 


CT 


IJZADC56 


AS 


iaZADC56 


AS 


iaZADC02 


AU 


iaZADC03 


AV 


IJZADC03 


AV 


IJZADC07 


AX 


IJZADC57 


AG 


IJZADC22 


BH 


iaZADC71 


CK 


iaZADC71 


CN 


iaZADC71 


CN 


iaZADC32 


AK 


IJZADCID 


EF 


IJZADC39 


BS 


IJZADCOO 


AP 


IJZADCOO 


AP 


IJZADC31 


AH 


IJZADC32 


AF 


IJZADC33 


AN 
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116 II I FOR HELP, ENTER PROMPT XXX TO KEXT DEV/TEST/OPT/MESSAGE 

E163I I RETAIN/370 REAEY 

E163I I RETAIN/370 READY 

E164I I CANNOT LINK TO RETAIN/370 CENTER 

£1641 I CANNOT LINK TO RETAIN/370 CENTER 

E165I I ENTRY IN DEVICE FLE NOT ALLOWABLE BY REMOTE 

E166I I OLT DOES NOT SDPPORT TALK 

E167I I PERMANENT ERROR ON REI DEVICE 

E167I I PERMANENT ERROR ON REI DEVICE 

E170I I NO PREVIOUSLY SELECTED DEVICE 

£1701 I NO PREVIOUSLY SELECTED TEST 

11691 I RETAIN/ 3 70 TERMINATED 

£1741 I UNABLE TO RESTORE LABEL ON DEVICE XXXX 

£1751 I SYNTAX ERROR 

£1761 1 MUTUALLY EXCLUSIVE OPTIONS HAVE BEEN SELECTED 

04E197DI MOUNT XXXXXX, REPLY DEV ADDR CR NC TC BYPASS 

£1981 1 NOT ALL ROUTINES SELECTED V^ERE RUN 

04E19 9DI INCORRECT REPLY 

0UE199EI INCORRECT REPLY 

04E199EI INCORRECT REPLY 

04E199DI INCORRECT REPLY 

04E199EI INCORRECT REPLY 

04£199E| INCORRECT REPLY 

04E19 9LI INCORRECT REPLY 

04E199EI INCORRECT REPLY 

04E199EI INCORRECT REPLY 

04E199DI INCORRECT REPLY 

£2011 I DEVICE DESCRIPTORS DC NOT N.EET XXXXXXX RECUIREiy.ENTS 

£2101 1 ROUTINE XXXX BYPASSED, MANUAL INTV EEGUIRED 

04E221E1 CAN FOREGROUND BE QUIESCPJD? REPLY YES CR NO 

£2221 1 STOP £OREGR0UND JOBS 

£2261 I OLTEP TERMINATED. CONSOLE KEYBCARD UNAVAILABLE 

£2271 I INSUFFICIENT SLTPORT FOR XXXXXXXX-01 

£2301 OLTEP CANCELED - SYSLST AS DASD NCT SUPPORTED 



1 I0ZADC52 


AE 


1 IJZADC76 


CR 


1 IGZADC77 


CS 


1 IJZADC76 


CR 


1 iaZADC77 


CS 


1 iaZADC31 


AH 


1 iaZADC52 


AE 


1 IJZADCIO 


EA 


1 IJZAE078 


CT 


1 IJZAEC52 


AE 


1 IJZAEC52 


AE 


1 IJZADC78 


CT 


1 IJZAD057 


AG 


1 IJZAE037 


ER 


1 IJZAD033 


AN 


1 IJZAE024 


EJ 


1 IJZAEOOO 


AP 


1 IJZAEO02 


AU 


1 IJZADO03 


AV 


1 IJZAE056 


AS 


1 IJZAEO07 


AX 


1 IJZAE022 


BE 


1 IJZAE052 


AE 


1 IJZAE024 


EJ 


1 IJZAE026 


BL 


1 IJZAE057 


AG 


1 IJZADO40 


ET 


1 IJZAEOOO 


AP 


1 IJZAE047 


CE 


1 IJZAEO40 


ET 


1 IJZAEO40 


ET 


1 IJZAEC52 


A£ 


1 IJZAEOOO 


AP 


1 IJZAECLT 


AA 
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E229I I SECTION XX, XXXXX. X BYPASSED. KCDE KCT AVAILABLE 

XX ..X CANNOT RUN ON YYYY 

OLTEP CANCELED - BG PARTITION LESS THAN 14 E 

DO NOT INITIATE ANY FOREGROUND JOBS 

DEVICE XXXX NOT TESTED. NO LOGICAL UNIT ASSIGKWENT 

DEVICE XXXX NOT TESTED. POIaER ACTIVE 

XXXX IS A TEST DEVICE - CANKCT BE USED 

XXXX IS A TEST DEVICE - CANNOT BE USED 

DEVICE XXXX HAS NO LOGICAL UKIT ASSIGNMENT 

DEVICE XXXX HAS NO LOGICAL UNIT ASSIGND^ENT 

XXXXXXXX BYPASSED- CORE NOT AVAILABLE 

KEYBOARD UNAVAILABLE 

LOST DATA - RE-ENTER MESSAGE 

EQU NOT ALLOV^ED FRCM REMOTE 

WILL CPU SHARED DEVS BE USED BY OTHERS 

TEE FOLLOVvING CU TEST DEVS ARE CPU SHARED 

TEE FOLLOWING CU TEST DEVS i^RE NOT ASSIGNED TO BG 

TEE FOLLOWING CU TEST DEVS ARE SYSTEM DEVS 

OLTEP CANCELED-CANNOT RUN IK VIRTUAL MODE 

when card input is used^ selections are printed en 
SYSLST and SYSLOG 

DUPLICATE ENTRIES IN DEVICE FIELD 

SYMBOLIC NAMES AND UNIT ADDRESSES MIXED IN DEVICE FIELD 

OLT MODULE XXXXXXXX NOT FOUND IN LIBRARY 

OLTEP CANCELED - RUNS ONLY IN BG PARTITION 

INPUT DEVICE MUST BE A TAPE 

UNIT TEST CANCELED, ATTEMPTED TO WRITE ON A FILE 
PROTECTED DEVICE 

SHOULD RECORDER FILE BE USED, REPLY YES OR NO 

MOUNT LOGSCAN TAPE, REPLY DEV ADDR OR NO TO BYPASS 

(contents of the EXT= field are printed) 

ENTER DEV EQUATES/iND/CLR 

ACTIVE EQUATES SELECTED 

AFE EQUATES CCRREC1 ? YES/NC 

INVALID ENTRY XXXXXX 

EQUATED DEVICES EXCEED 16 



E231I 


E232I 


E233I 


E234I 


E235I 


E236I 


E236I 


E237I 


E237I 


E238I 


E239I 


E241I 


E242I 


04E243D 


E244I 


E244I 


E244I 


E245I 


E250I 


E251I 


E252I 


j E253I 


B265I 


E306I 


E313I 


04E323E 


04E324D 


E327I 


04E394D 


E395I 


04E396D 


E397I 


E398I 



1 IJZAEO40I 


ET 


1 IJZAEOOOI 


AP 


1 IJZADOLTI 


AA 


1 IJZADO40I 


ET 


1 IJZAD031I 


AE 


1 IJZAD031I 


AE 


1 IJZAC024I 


EJ 


1 IJZAD026I 


EL 


1 1JZAC024: 


EJ 


1 IJZAE026i 


PL 


1 IJZACOOO 


AP 


1 IJZAECOO 


AP 


1 IJZACOIO 


EA 


1 1JZAC052 


A£ 


1 IJZACOAJ 


EJ 


1 IJZACOAJ 


EJ 


1 IJZACCAJ 


EJ 


1 IJZACOAJ 


EJ 


1 IJZACOLT 


AA 


1 IJZACOLT 


AA 


1 IJZAEC31 


AE 


1 IJZACC31 


AH 


1 IJZA0028 


BM 


! IJZAECLT 


AA 


1 IJZAE026 


EL 


1 IJZAECLE 


EE 


1 IJZAEC26 


1 BE 


1 IJZADC26 


1 EL 


I IJZADC33 


1 AN 


1 IJZADC49 


1 CE 


1 IJZADC49 


1 CE 


1 IJZADC49 


1 CE 


i 1JZADC49 


i CE 


1 IJZADC49 


1 CE 
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E399II EQUATED LEV ADDRESS AND $CUTEST ARE MUTUALLY EXCLUSIVE 

E400I I TP LINE CONNECTION, LINE=XXXX TERiyiINAL=XXXXXXXX 

E401I I REQUIRED DATA NOT FOUND IN CDS FOR XXXXXXXX 

E402I I SYMBOLIC NAME FIELD NOT PRESENT IN CDS 

E403I I INVALID LINE CONN COMMAND SEQUENCE IN CDS 

E404I I DIAL DIGIT COUNT EXCEEDS 20 

E405I I OPERATOR CALL REQUIRED, TELEPHONE NUMBER NOT PROVIDED 

I IN CDS 

E406I I OPERATOR CALL TERMINAL ON NUMBER XYZ 

E407I I OPERATOR CALL NOT COMPLETED WITHIN TIME LIMITS 

E408I I SIO RETURNED A CC=3, NOT OPERATIONAL 

E409I i SIO FINAL STATUS ERROR CSW=XXXXXXXXXXXXXXXX SNS=YYYY 

E410I I FINAL STATUS NOT RECEIVED FROM I/O OPERATION 

E412I I COW CHAIN TERMINATED ON XXXXXXXXXXXXXXXX 

E413I I REQUIRED CDS POINTER NOT PRESENT 

E414I I ALL TEST TP LINES WILL BE DISABLED 

E450I I * RTN UUU, ID VV, AT WWWWWW, RC XX 

E501I I T2400W BYPASSED, INVALID TEST 
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Glossary of OLTEP Terms 



For a more complete list of data processing 
terms, refer to the IBM Eata Processing 
Techniques, A Data Processing Glossary, 
GC20-1699. 

ASCIj (American National Standard Code for 
Information Interchange) : A 128-character, 
7-bit code. The high-order hit in the 
System/ 360 8-bit environment is zero. 

CE cell : A data cell used to test an IBK 
2321. A CE cell is recognized by a sense 
to bin 0, subcell 19. If the CE sense bit 
is on, the CE cell is mounted. 

CE pack ; A disk pack used tc test an IBK 
2311, 2314, or 3330. It has a volume label 
of VOLICEPACK. 



On -Line Test (OLT) : A test program of the 
on-line test system. The tests reside in 
the core image library, and are brought 
into core storage by OITEP when requested 
by the operator. 



On -Line Test Executive Program (OITEP ) : 
The control program of the cn-line test 
system,. OLTEP is the interface between the 
on-line test and the operating system. 



on-line test system : A ccntrcl program, 
OLTEP, and a series of tests (OLTs) 
designed tc test I/O devices without 
interrupting normal system processing. 



CE volume ; A factory formatted pack 
designed for use only with On-Line Test 
Diagnostics. 

communications interval : A period of 
communication between the console operator 
and OLTEP. The operator is requested by 
OLTEP to enter the test- run definition at 
this time. 

data protection : A procedure invoked to 
prevent the loss or destruction of customer 
data. 

data security : A safeguard invoked to 
prevent the accessing of customer data. 

default value ; A predetermined value used 
in place of an omitted entry. 

Bivironmiental Recording Errcr Procedures 
(EREP) : A DOS system utility program used 
for processing system environmental records 
recorded on the Environmental Recording 
I^ta Set (HIDS) known as the IJSYSRC 
(SYSREC) file. 

expiration date : A date within a tape 
label for Data protection. The tape may 
not be used as a scratch tape without 
operator permission until this date has 
expired . 

File Protect Mode (FPM) : A mode of 
operation that insures maximum protection 
and security of customer data. While in 
file protect mode, the system performs no 
write operations. 



privileged instruction : An instructicn 
that can be executed only while the CPU is 
in the supervisor state. Protection, I/O, 
direct control, and any instructions that 
manipulate the program status words are 
privileged. 



p rompting : A request for help made by the 
operator when entering the test- run 
definition. OLTEP prints examples of the 
field requested by the cperatcr. 

Quiesce Node : A mode of operation that 
requires the foreground partitions to be 
stopped by the cperatcr. The operator does 
this on the ccnsole by issuing the PAUSE 
EOJ and STCP commands when requested by 
OLTEP. 

Recove ry M anagement Support Recorder 
(RKSR): Gathers informaticn about the 
reliability of the hardware which records 
the raiords produced cntc the Environmental 
Recording Data Set (ERDS). 

supervisor state : The state of CPU 
operation that allows execution of 
privileged instructions. When bit 15 of 
the PSW is zero, the CPU is in the 
supervisor state. 

test- r un definition : Information requested 
by OLTEP at the various ccmmunicaticns 
intervals. This informaticn consists of 
the device tc be tested, the test or test 
routines to be executed, and the options to 
be exercised. 
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Index 



Indexes to systems reference library 
manuals are consolidated in the publication 
DOS Master Index , GC2a-5063* For 
additional information about any subject 
listed below, refer to other publications 
for the saipe subject in the faster Index,. 



features cf CITEP 9 

file protect lEcde 12 

first error ccnirouni cat ions irterval 11 

flovicharts 53 

FFM 12 

FREECOEE 42 

functions cf OLTEF 9 



$$EOLTEP 49 
$$BTOLTP 49 
$DDATE 47 
$DTIMI 48 
$MODE 40 



abbreviations 53 

accessing of environirental recording data 

13 
M.OCAT 33 



Ci^NCEL 11,22 

COfi message 44 

CE communication 49 

CE volume 12 

CEPACK 12 

CECOM 38 

communications interval 11,15,22 

compare 50 

convert 40,50 

CSW message 44 



DASD 12 

data integrity 10 

data protection 11, 15 
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direct access storage devices 12 
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IBM 2321 28 

modules 11 

tape 29 
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decode modules 15 
device decode 24 
device ready check 12 
DIO 42 

direct access storage devices 12 
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EUMP 22 
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error recovery procedures 10 
EX 10 36 
external interrupt handler 15,21 
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LOGS CAN 35 



main flo\f« 55 

message cress reference 157 

MORECORE 41 



non-file protect ircde 12 
nucleus 15,17 



OLT 11 
OLTEF 

function 9 

primary' ircdules 15 

strix^ture 10 
Cn line Tests (OLTS) 11 
operator ccmmunicaticn 11 
option decode 26 
output 52 
output v^riter 46 



partition size 10 

FIIlSiK 36 

pre-release 25 support modules 49 

print 51 

print comnjent 51 

print heading 51 

print result 51 

prompt 46 

protection of customer data 11 



random data generator 52 

PEADD 34 

reformatted volumes 12 

register ccnventicns 13 

REI 14,22 

BEI initialize #1 46 

BEI initialize #2 47 

BEI nucleus 31 

BEI terminate 47 

remote analysis center 14 

restore label routine 23 

BETAIlS;/370 14 

BE'IAIK/370 interface 10 

return code usage 13 

routine 43 



scheduler 15,27 
sense/data 45 
size requirements 10 
space allocation 12 
STOFBEI 23 

structure of OLTEF 10 
supervisor 9 
support modules 31 

pre-release 49 
symbols 53 
SYSIST device 46 



tape devices 11 
tape label 11 

ASCII 11 

expiration date 12 

restoring 23 

security byte 11 



166 DOS/VS OLTEP Logic 



standard 11 user language 10 

terminate OLTEP 94 uses of OITEF 9 

test decode 25 
test volume 12 
test-run definition 10 

test completion coirmunicaticns interval 11 WAITIO 37 
TP line connection 31 
transient manager 15,17,18 
transient modules 10 
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